팬덤박스_API

자주 묻는 질문 (FAQ)

Q. [API] Q. [팬덤박스 API] API를 위한 별도의 테스트 계정 또는 테스트 환경이 제공되나요?
네, 'test-api.maze.games' URL에서 테스트 환경 및 계정이 제공됩니다.
Q. [API] Q. [팬덤박스 API] Status : 429 오류가 발생합니다. 어떻게 해야 하나요?
인증키별로 최대 접속량이 분당 10,000회로 제한됩니다. 이 한도를 초과하면 일시적으로 차단될 수 있으니, 오류 발생 시 반복 호출을 피해주세요.
Q. [API] Q. [MAZE API] API 인증을 위한 HMAC 생성 가이드가 있나요?

네, HMAC은 해시 메시지 인증코드(keyed-hash message authentication code)의 준말로 RFC 2104 표준 암호화 프로토콜입니다. 현재 Coupang openAPI는 HMAC 기반으로 제작되었으며, 모든 request header의 'Authorization'에 생성한 HMAC signature를 함께 보내주셔야 합니다.

HMAC Signature 생성+API 요청 예제

Java

Python

PHP

C#

Node.js
Q. [API] Q. [팬덤박스 API] API Key(Client_id Key, Client_secret Key)는 어디서 발급 및 확인할 수 있나요?
- 로그인 후 진행: 웹사이트에 로그인하신 후, 우측 상단에서 사용자의 이름을 클릭합니다.
- 개인 정보 접근: 드롭다운 메뉴에서 '내 정보'를 선택합니다.
- API 관리: 상단 메뉴에서 'API'를 클릭한 다음, 보안을 위해 비밀번호를 입력합니다.
Q. [API] Q. [팬덤박스 API] OpenAPI Key의 유효기간은 어떻게 되나요?
OpenAPI Key 자체에는 유효기간이 없으나, Access Token은 유효기간이 12개월입니다. Access Token이 만료되면 발급받으신 Key로 재발급 받으시면 됩니다.
Q. [API] Q. [팬덤박스 API] API 연동정보 수정은 언제든지 가능한가요?
네, API 연동정보 수정은 언제든지 가능합니다.
Q. [API] Q. [팬덤박스 API] API Key 발급 또는 연동업체 정보, IP 주소 수정 시 바로 사용이 가능한가요?
API Key 발급, 연동업체 정보 수정, 또는 자체개발 내의 IP 주소 수정 시, 시스템 반영에 일정 시간이 필요합니다. 수정 후 최소 30분 이후에 사용해 주시기 바랍니다.
Q. [API] Q. [팬덤박스 API] OpenAPI Key 발급 시, 연동업체와 자체개발을 동시에 등록할 수 있나요?
아니요, OpenAPI Key는 계정별로 하나만 발급 가능하며, 연동업체 하나와 자체개발 하나를 동시에 등록할 수 없습니다.
Q. [API] Q. [팬덤박스 API] OpenAPI Key 발급 시, 여러 연동업체를 등록할 수 있나요?
아니요, OpenAPI Key는 계정별로 하나만 발급 가능하며, 두 개 이상의 연동업체를 추가 등록할 수 없습니다. API Key 발급 가이드는 API 소개 내용을 참고해 주시기 바랍니다.
Q. [API] Q. [팬덤박스 API] 응답 오류 처리
- Key와 Value 검증: 'Body -> form-data' 섹션에서 입력한 Key와 Value가 정확한지 확인합니다. 오류 메시지는 특정 Key의 배열 값이 정의되지 않았다는 것을 나타내며, 이는 필드가 올바르게 입력되었는지 여부를 검토해야 함을 의미합니다.