배지 발급 (다건)

POST

/badges/batch

하나의 템플릿으로 여러 수령인에게 배지를 일괄 발급합니다. 한 요청당 최대 1,000건입니다.

발급은 비동기로 처리됩니다. 요청은 202로 접수되며 각 건마다 badge_id가 채번됩니다. 발급 완료 여부는 발급이력 조회(recipient_email·title 필터)로 확인하십시오.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

Request Body (JSON)

필드명	타입	필수 여부	기본값	설명
template_id	string	Required	-	발급할 템플릿 ID
recipients	array<object>	Required	-	수령인 목록 (최대 1000건)
↳ recipient_name	string	Required	-	수령인 이름
↳ recipient_email	string	Required	-	수령인 이메일

Responses

발급 접수

Content-Type

application/json

{

  

"code": "0002",

  

"message": "다건 발급 요청이 접수되었습니다.",

  

"data": {

  

  

"total_count": 2,

  

  

"accepted_count": 2,

  

  

"items": [

  

  

  

{

  

  

  

  

"recipient_email": "johwangg@dainls.com",

  

  

  

  

"badge_id": "0QQMHSW5M3AQV",

  

  

  

  

"status_cd": "ISSUE_WAIT"

  

  

  

},

  

  

  

{

  

  

  

  

"recipient_email": "kcs@dainls.com",

  

  

  

  

"badge_id": "0QQMHSW5M3AQW",

  

  

  

  

"status_cd": "ISSUE_WAIT"

  

  

  

}

  

  

]

  

}

}

POST

/badges/batch

Samples