# API 사용 방법

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

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

### API 헤더

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

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

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

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

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

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

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

### API 요청 한도

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

### API 업데이트 정책

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

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

### 통합 솔루션

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

신규 통합 솔루션 업체 담당자로 API 연동을 희망하시는 경우, [이 링크](https://toss.im/_m/tFYQJMUj)의 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><ol><li>API 인증 토큰 발급</li></ol></td><td><a href="/pages/9tjgB0MdygRgbvBlEYgu">/pages/9tjgB0MdygRgbvBlEYgu</a></td></tr><tr><td><ol start="2"><li>상품 등록</li></ol></td><td><a href="/pages/UmxG9deRXiAmTSvOBL4m">/pages/UmxG9deRXiAmTSvOBL4m</a></td></tr><tr><td><ol start="3"><li>클레임 처리</li></ol></td><td><a href="/pages/xDjAxF3Fl9bKcsNhw5eD">/pages/xDjAxF3Fl9bKcsNhw5eD</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="/pages/BxU6SuiRiZHPQKekNJeP">/pages/BxU6SuiRiZHPQKekNJeP</a></td></tr><tr><td>상품</td><td><a href="/pages/5cWPgIIQ9V4qMONR67Ha">/pages/5cWPgIIQ9V4qMONR67Ha</a></td></tr><tr><td>주문</td><td><a href="/pages/JsbEZKg9GSkXJdMunQ4F">/pages/JsbEZKg9GSkXJdMunQ4F</a></td></tr><tr><td>배송</td><td><a href="/pages/fxlw9CXilwki3p06lvNK">/pages/fxlw9CXilwki3p06lvNK</a></td></tr><tr><td>클레임</td><td><a href="/pages/J7WQNZlzYUum2VRJw6dG">/pages/J7WQNZlzYUum2VRJw6dG</a></td></tr><tr><td>정산</td><td><a href="/pages/rhDD4XfFq6DUQTiOABfd">/pages/rhDD4XfFq6DUQTiOABfd</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shopping-docs.toss.im/dev/api-intro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.