# API 사용 방법

> ### API 연동 중 문의사항이나 개선 제안이 있으신가요?

{% hint style="info" %}
토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 [연동/개발 문의](https://discord.gg/xPz6H9NZ3P)에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.
{% endhint %}

### API 헤더

토스쇼핑 API 요청은 HTTPS 환경에서 JSON 형식으로 호출해주세요.

```bash
Content-Type: application/json
```

인증에는 Bearer 인증을 사용해요. Bearer 인증에 필요한 [인증 토큰을 발급](https://shopping-docs.toss.im/dev/api-1/token)받은 다음에 API를 사용해주세요.

```bash
Authorizaton: {ACCESS_TOKEN}
```

### 토스쇼핑 엔드포인트 URL

원할한 연동을 위해 운영 환경과 유사한 테스트 환경 엔드포인트를 별도로 제공하고 있어요. [테스트 환경 설정 방법](https://shopping-docs.toss.im/dev/api-1/test)을 참고해주세요.

* 운영 환경: `https://shopping-fep.toss.im`
* 테스트 환경: `https://shopping-fep-alpha.toss.im`

### API 요청 한도

셀러 당 각 API별로 요청횟수를 쓰기 초당 30회, 읽기 초당 50회 이하로 제한하고 있어요. 그 이상으로 요청을 보낼 시 일부 요청에 대해서 response에  `TOO_MANY_REQUEST` ErrorType을 내려주며 거절될 수 있어요.

### API 업데이트 정책

연동을 시작하기 전에 아래 토스쇼핑 API 정책을 확인해주세요.

* API 응답 필드와 에러 코드는 예고 없이 추가, 변경될 수 있어요. 업데이트로 인한 오류가 발생하지 않도록 주의하세요.&#x20;
* API를 제거할 때는, API가 제거된다고 미리 알려드려요. API가 제거된 후 호출되면 접근이 제한돼요.&#x20;
* 자세한 API 업데이트 내용은 공지사항을 확인해주세요.&#x20;

### 통합 솔루션

통합 솔루션 업체(사방넷, 플레이오토 등)를 통해 연동하는 경우에는 해당 통합 솔루션 업체의 가이드를 참고해주세요.

신규 통합 솔루션 업체 담당자로 API 연동을 희망하시는 경우, [이 링크](https://toss.im/_m/tFYQJMUj)의 API 연동 문의사항에 작성하여 제출해주세요.&#x20;

### 연동 시작하기

#### 연동 가이드

아래 가이드를 따라 연동을 바로 시작해보세요.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><ol><li>API 인증 토큰 발급</li></ol></td><td><a href="api-1/token">token</a></td></tr><tr><td><ol start="2"><li>상품 등록</li></ol></td><td><a href="api-1/register-product">register-product</a></td></tr><tr><td><ol start="3"><li>클레임 처리</li></ol></td><td><a href="api-1/claim">claim</a></td></tr></tbody></table>

#### API 목록

토스쇼핑 API 목록을 탐색해보세요.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>카테고리</td><td><a href="api-2/category">category</a></td></tr><tr><td>상품</td><td><a href="api-2/product">product</a></td></tr><tr><td>주문</td><td><a href="api-2/order">order</a></td></tr><tr><td>배송</td><td><a href="api-2/delivery">delivery</a></td></tr><tr><td>클레임</td><td><a href="api-2/claim">claim</a></td></tr><tr><td>정산</td><td><a href="api-2/settlement">settlement</a></td></tr></tbody></table>
