헤드리스 사용 가이드

헤드리스 사용 시 친구톡 사용 가이드 입니다.

친구톡 캠페인 통계 동작 원리

• 친구톡 발송 시 링크되는 URL 에 trackingKey 를 파라메터로 전달합니다.

• 예를 들어 쇼핑몰 홈페이지로 클릭을 유도하는 친구톡 발행 시 http://쇼핑몰주소?trackingKey={친구톡캠페인의추적키} 로 링크가 전달됩니다.

• 쇼핑몰에서는 전달된 trackingKey 를 request 값으로 전달하면 웹훅 이벤트를 통해 친구톡 통계 DB에 수집됩니다.

---

trackingKey 를 전달해야 하는 API

◼︎ 로그인

아래 API 에 query parameter로 전달받은 trackingKey 를 전달합니다.

• ID, PW 를 이용하여 accessToken 발행하여 로그인 하는 API
• open ID 로그인을 이용하여 accessToken 을 발행하여 로그인 하는 API

✓ 예제

curl --request POST
--url https://shop-api.shopby.co.kr/oauth/token?trackingKey={친구톡캠페인의추적키}
--header 'accept: application/json'
--header 'clientid: {쇼핑몰의 clientid} '
--header 'content-type: application/json'
--header 'platform: PC'
--header 'version: 1.0'
--data '{"memberId":"gildong","password":"testpw123","keepLogin":true,"captcha":null,"provider":null}'

◼︎ 주문

아래 API 에 query parameter로 전달받은 trackingKey 를 전달합니다.

• 주문서 작성하기 API