> For the complete documentation index, see [llms.txt](https://store-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://store-help.nhn-commerce.com/app/counsel/kakao_friend_talk/07.md).

# 헤드리스 사용 가이드

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

* 친구톡 발송 시 링크되는 URL 에 trackingKey 를 파라메터로 전달합니다.
* 예를 들어 쇼핑몰 홈페이지로 클릭을 유도하는 친구톡 발행 시 <mark style="color:blue;"><http://쇼핑몰주소?trackingKey={친구톡캠페인의추적키}></mark> 로 링크가 전달됩니다.&#x20;
* 쇼핑몰에서는 전달된 trackingKey 를 request 값으로 전달하면 웹훅 이벤트를 통해 친구톡 통계 DB에 수집됩니다.

<figure><img src="/files/acQCij6pJKrzTJT4AsRH" alt=""><figcaption></figcaption></figure>

***

## trackingKey 를 전달해야 하는 API

### **◼︎ 로그인**

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

* [ID, PW 를 이용하여 accessToken 발행하여 로그인 하는 API](https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/post-oauth-token-1-success)<br>
* [open ID 로그인을 이용하여 accessToken 을 발행하여 로그인 하는 API<br>](https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/post-oauth-openid)

<mark style="color:purple;">**✓  예제**</mark>

{% code overflow="wrap" %}

```
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}'
```

{% endcode %}

### **◼︎ 주문**

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

* [주문서 작성하기 API](https://docs.shopby.co.kr/?url.primaryName=order/#/OrderSheet/post-order-sheet)

<figure><img src="/files/e1mVUQxQLxKxDRpsNUVY" alt=""><figcaption></figcaption></figure>

<img alt="" class="gitbook-drawing">