배지 회수 (다건)

POST

/badges/revoke

발급된 배지를 회수합니다. 한 요청당 최대 1,000건입니다.

회수는 비동기로 처리되며, 요청은 202 응답값으로 처리됩니다.

회수 가능 대상(발급완료)만 접수되며, 접수 건수는 응답의 accepted_count로 반환됩니다.

회수 완료 여부는 배지 상세 조회 또는 발급이력 조회로 확인하세요하십시오.

주의: 발급완료(ISSUED) 상태가 아닌 배지는 별도의 알림 없이 제외하고 처리됩니다.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

Request Body (JSON)

필드명	타입	필수 여부	기본값	설명
badge_ids	array<string>	Required	-	회수할 배지 ID 목록 (최대 1000건)
reason	string	Required	-	회수 사유 (필수)

Responses

회수 접수

Content-Type

application/json

{

  

"code": "0003",

  

"message": "회수 요청이 접수되었습니다.",

  

"data": {

  

  

"total_count": 1,

  

  

"accepted_count": 1

  

}

}

POST

/badges/revoke

Samples