이용 가능한 구매자 마켓: 한국
본 API는 brandId를 통해 브랜드의 상세 정보를 조회하는 데 사용됩니다.
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId}
호출 예시
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/brands/{brandId}
요청 파라미터
Body 파라미터
| 파라미터명 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| brandId | O | String | 고유 브랜드 식별자 (예: KR-5) |
요청 예시
없음
응답 메시지
| 파라미터명 | 타입 | 설명 | |
|---|---|---|---|
| code | String | 결과코드 SUCCESS/ERROR | |
| message | String | 메시지 | |
| data | Object | ||
| brandId | String | 고유 브랜드 식별자 (예: KR-5) | |
| brandName | String | 브랜드명 (예: NIKE) | |
| brandLogoUrl | String | 브랜드 로고 이미지 URL (없으면 null) | |
| isUIDRequired | Boolean | 해당 브랜드에 UID(GTIN 또는 MPN) 입력이 필수인지 여부 | |
| allowedUIDTypes | Array[String] | 허용된 UID 유형 목록 (예: ["GTIN", "MPN"]) | |
Response Example
{
"code": "SUCCESS",
"message": "",
"data": {
"brandId": "KR-5",
"brandName": "NIKE",
"brandLogoUrl": "https://image11.coupangcdn.com/image/brand/logo/nike.png",
"isUIDRequired": true,
"allowedUIDTypes": ["GTIN", "MPN"]
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 Bad Request | 브랜드 조회에 실패했습니다. | 유효한 brandId인지 확인하세요. |
| 400 Bad Request | brandId 형식이 올바르지 않습니다. | brandId 형식을 확인하세요 (예: KR-5). |