[다운로드쿠폰] 아이템 생성

KRTW

# 01

요약

[다운로드쿠폰] 아이템 생성

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국

옵션상품(vendorItemId)에 생성된 다운로드 쿠폰을 적용하기 위한 API입니다.

상품 추가에 실패하면 해당 쿠폰은 파기됩니다.

경로

PUT/v2/providers/marketplace_openapi/apis/api/v1/coupon-items

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupon-items

URL API Name

Add_VENDOR_ITEMS_TO_COUPON

# 03

요청 본문

요청 파라미터

본문 파라미터

Name	Type	Description
couponItems*	object[]	상품 쿠폰적용을 위한 데이터
couponId couponItems[].couponId	string	쿠폰ID 쿠폰생성 Response에서 확인 가능
userId couponItems[].userId	string	사용자 계정 (WING 로그인 ID)
vendorItemIds couponItems[].vendorItemIds	object[]	쿠폰 적용하고자 하는 옵션ID(s) 한 번에 적용할 옵션ID 수는 100개를 초과할 수 없음

요청 예시application/json

{
  "couponItems": [
    {
      "couponId": "15350660",
      "userId": "testaccount1",
      "vendorItemIds": [
        2306264997,
        4802314648,
        4230264914
      ]
    }
  ]
}

# 04

응답 본문

응답 메시지

Name	Type	Description
requestResultStatus	string	호출 결과 SUCCESS / FAIL
body	object
couponId body.couponId	integer	해당 쿠폰 ID
errorCode	string	에러발생 시 분류
errorMessage	string	에러 상세내용

Response Example

{
  "requestResultStatus": "SUCCESS",
  "body": {
    "couponId": 15350660
  },
  "errorCode": null,
  "errorMessage": null
}

# 05

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400 (요청변수확인)	삭제된 프로모션 입니다.	쿠폰ID(couponId) 값을 올바로 입력했는지 확인합니다. 옵션에 쿠폰 적용이 실패하여 쿠폰ID가 삭제되었는지 확인합니다.