기타문의 – Open APIs

TLS version upgrade 방법 안내

Coupang 은 보안 위험성으로 인해 TLS v1.0, v1.1 에 대한 지원을 하지 않습니다. 따라서 openapi 호출 시 다음과 같은 오류 메시지를 수신하였다면, TLS 버전을 업그레이드하여야 합니다. javax.net.ssl.SSLException: Received fatal alert: protocol_version Java java... 더보기

고시정보 개정에 대한 API 셀러용 가이드

공정거래위원회에서 개정 시행하는 ‘전자상거래 등에서의 상품 등의 정보제공에 관한 고시(이하 상품정보제공고시)’에 따라11월 23일 쿠팡의 고시정보가 개정되었습니다. OPEN API를 이용하시는 판매자님을 위해 아래와 같이 개정된 고시정보 항목을 전달드립니다. 아래의 변경사항을 판매자님이 상품을 '생성 및 수정'하실 때 반드시 적용해 주시기 바랍니다... 더보기

API를 위한 별도의 테스트 계정 또는 테스트 환경이 제공되나요?

별도의 테스트 환경이 제공되지 않으니 이점 양해 부탁드립니다. 더보기

상품 오매칭으로 인해 잘못된 이미지 노출이 발생했습니다. 어떻게 해야 하나요?

상품 오매칭 또는 오머지가 발견될 경우 아래 링크 [상품 결합 및 분리 요청 드립니다.] 또는 "WING > 판매자지원 > 온라인 문의" 메뉴의 "상품관리 > 상품수정 > 상품 결합 및 분리 요청 드립니다." 에서 상품분리 또는 결합 요청을 해주시기 바랍니다. 더보기

쿠팡 OpenAPI 사용을 위해 서버 IP 주소를 등록해야 하나요?

당사에서 제공하는 API 게이트웨이 (https://api-gateway.coupang.com) 을 이용하시는데에 별도의 방화벽 신청은 필요하지 않습니다. 더보기

OPENAPI 의 swagger 정보를 확인하고 싶습니다.

쿠팡에서 제공하는 OPENAPI 의 swagger 정보는 SDK를 다운로드받아서 확인할 수 있습니다. swagger 파일 경로 SDK ㄴ resources ㄴ marketplace-seller-api-spec.json swagger 파일을 이용하여 SDK에서 지원하지 않는 php, python, C# 등의 다양한 언어의 API c... 더보기

521 오류가 리턴되는데 어떻게 해야하나요?

<API 제공자와의 연결 실패> 클라이언트와 쿠팡 API Gateway까지 연결은 되었지만 API 제공자의 서버에 문제가 있는 경우입니다. 더보기

423 오류가 리턴되는데 어떻게 해야하나요?

<잠김> 호출하려는 API 호출이 제한되어 있는 경우입니다. 추가 지원이 필요하실 경우 쿠팡 판매자 콜센터 또는 온라인문의로 연락주시기 바랍니다. 더보기

412 오류가 리턴되는데 어떻게 해야하나요?

<배포되지 않음> 호출하려는 API가 활성화되지 않은 경우입니다. 더보기

500 오류가 리턴되는데 어떻게 해야하나요?

Internal Server Error 또는 "Internal Exception 과 같은 오류가 발생한 경우 전송하신 항목에 오류가 있을 경우, 주로 발생합니다. 오탈자가 없는지 먼저 확인 바라며, [개발자 포탈]에서 제공 중인 예문과 비교하여 확인하시는 것을 권장합니다. 더보기

429 오류가 리턴되는데 어떻게 해야하나요?

<너무 많은 요청> API를 너무 많이 호출했을 때 발생하는 코드로, 다음 사항들에 의해 그 기준이 결정될 수 있습니다. 쓰로틀링을 설정한 상태에서, 쓰로틀링 임계치(약 90%)에 도달한 경우 (X-CAG-Warnings로 쓰로틀링 관련 값이 전달됩니다.) X-Extended-Timeout 헤더를 명시했을 때 호출 횟수가 과한 경우 더보기

504 오류가 리턴되는데 어떻게 해야하나요?

<시간 초과> 정해진 응답시간을 초과했을 경우입니다. 기본 API Gateway 응답시간은 3초로 정해져 있습니다. 헤더를 통해 X-Extended-Timeout 값을 조정(가이드)하여 변경할 수 있으나, 그 이후에도 발생 시에는 온라인으로 문의 바랍니다. 더보기

타임아웃(timeout) 에러가 발생합니다.

아래의 코드를 발주서(PO) 조회/반품조회/교환 조회나 상품등록처럼 전송하거나 받는 ,json data의 사이즈가 커질수 있는 API에 대해 추가하셔서 client side의 timeout 시간을 늘려주시기 바랍니다. 1. 일반 Java 코드 예제 HttpGet get = new HttpGet(uriBuilder.build().toString())... 더보기

410 오류가 리턴되는데 어떻게 해야하나요?

<사라짐> 호출하려는 API가 만료된 경우입니다. 추가 지원이 필요하실 경우 쿠팡 판매자 콜센터 또는 온라인문의로 연락주시기 바랍니다. 더보기

'400 Bad Request'라는 오류가 리턴되는데 어떻게 해야하나요?

클라이언트에서 잘못된 파라메터 등 요청이 잘못된 경우에 발생합니다. 메시지에 따라 요청을 수정하여 다시 요청하시면 됩니다. 이후에도 문제가 발생 시 쿠팡 판매자 콜센터 또는 온라인문의로 연락주시기 바랍니다. 더보기

524 오류가 리턴되는데 어떻게 해야하나요?

<API 제공자와의 접속 시도 실패>보통 클라이언트가 사용하고자 하는 API 제공자의 호스트 설정이 잘못된 경우에 발생합니다.다음 사항들이 원인이 될 수 있습니다. 호스트 기본 설정값인 0.0.0.0을 바꾸지 않고 API 호출 기존에 사용하지 않던 Profile에서 호출 (ex) IT Zone에서 API 제공자가 설정하지 않았는데, 클라이언트가 ... 더보기

'404 Not Found'라는 오류가 리턴되는데 어떻게 해야하나요?

URI(Uniform Resource Identifier)가 잘못된 경우입니다. 다시 한번 확인하여 재시도 바랍니다. 더보기

'401 Unauthorized'라는 오류가 리턴되는데 어떻게 해야하나요?

Hmac Signature 생성이 잘못된 경우에 발생합니다. Hmac 생성 시에 서버 시간도 파라메터에 포함하고 있기 때문에 API 요청 시 마다 Hmac을 새로 생성해서 보내주셔야 합니다.따라서 서버 시간이 잘못되었을 경우에도 인증실패가 납니다. 개발환경이 .NET인 경우에는 기본 제공 되는 “WebRequest / WebClient”에서 인코딩된... 더보기

OPENAPI 관련 안내