쿠폰
쿠폰 지급
셀러 지급(`MANUAL`) 쿠폰을 구매자에게 준다. 한 번에 1,000명까지다. 구매자마다 따로 처리하고, 한도에 걸린 구매자는 `failed`에 담는다. 같은 `Idempotency-Key`로 다시 보내면 첫 결과를 돌려준다.
POST
셀러 지급(MANUAL) 쿠폰을 구매자에게 준다. 한 번에 1,000명까지다. 구매자마다 따로 처리하고, 한도에 걸린 구매자는 failed에 담는다. 같은 Idempotency-Key로 다시 보내면 첫 결과를 돌려준다.
accessTokenheader
AuthorizationBearer <token>Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)
couponId*stringX-Store-Id*string대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다
idempotency-key?string멱등키. 같은 키로 다시 보내면 처음 결과를 돌려주고 한 번만 적용한다. 재시도에는 같은 키를 쓴다
Length
length <= 255application/json- body
customerIds*array<>지급할 구매자 id(1~1,000명, 중복 불가)
Items
1 <= items <= 1000성공
application/json- response
meta*data*error*|nullcurl -X POST 'https://api.sayren.io/v1/coupons/string/issues' \ -H 'X-Store-Id: string' \ -H 'Content-Type: application/json' \ -d '{ "customerIds": [ "string" ]}'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "issued": [ { "customerId": "string", "issueId": "string" } ], "failed": [ { "customerId": "string", "code": "string", "message": "string" } ] }, "error": null}