배지 발급 (단건)

POST

/badges

수령인 정보와 템플릿 ID로 배지 1건을 발급합니다.

발급은 비동기로 처리됩니다. 요청은 202로 접수되며 badge_id가 채번됩니다. 발급 완료 여부는 배지 상세 조회 또는 발급이력 조회로 확인하십시오(상태 발급완료).

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

Request Body (JSON)

필드명	타입	필수 여부	기본값	설명
template_id	string	Required	-	발급할 템플릿 ID
recipient_name	string	Required	-	수령인 이름
recipient_email	string	Required	-	수령인 이메일

Responses

발급 접수

Content-Type

application/json

{

  

"code": "0002",

  

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

  

"data": {

  

  

"badge_id": "0QQMHSW5M3AQV",

  

  

"status_cd": "ISSUE_WAIT"

  

}

}

POST

/badges

Samples