API 사용 방법

토스쇼핑 API 요청 형식과 엔드포인트를 안내해요.

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

토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 연동/개발 문의에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.

API 헤더

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

Content-Type: application/json

인증에는 Bearer 인증을 사용해요. Bearer 인증에 필요한 인증 토큰을 발급받은 다음에 API를 사용해주세요.

Authorizaton: {ACCESS_TOKEN}

토스쇼핑 엔드포인트 URL

원할한 연동을 위해 운영 환경과 유사한 테스트 환경 엔드포인트를 별도로 제공하고 있어요. 테스트 환경 설정 방법을 참고해주세요.

• 운영 환경: 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 연동을 희망하시는 경우, 이 링크의 API 연동 문의사항에 작성하여 제출해주세요.

연동 시작하기

연동 가이드

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

1. API 인증 토큰 발급

1. 상품 등록

1. 클레임 처리

API 목록

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

카테고리

상품

주문

배송

클레임

정산