발급·회수 흐름

발급과 회수는 비동기로 처리됩니다. 요청하면 202로 접수만 확인되고, 실제 처리 결과는 배지 상태 조회로 확인합니다.

발급

POST /badges(단건) 또는 POST /badges/batch(다건)를 호출하면, 배지가 즉시 발급되는 것이 아니라 발급 요청이 접수되고 202 응답이 반환됩니다.

json

// POST /badges 응답 (202)
{
  "code": "0002",
  "message": "발급 요청이 접수되었습니다.",
  "data": { "badge_id": "0QQMHSW5M3AQV", "status_cd": "ISSUE_WAIT" }
}

다건(batch)은 data 에 total_count·accepted_count 와 수신자별 items[](recipient_email, badge_id, status_cd)가 담깁니다.

접수 후 완료까지 최소 5분 ~ 1일까지 소요될 수 있으며, GET /badges/{badge_id} 로 인증서 발급 상태를 확인할 수 있습니다.

회수

POST /badges/revoke 에 badge_ids(필수)와 reason(필수)을 전달하면 회수 요청이 접수되고 202가 반환됩니다. 회수는 발급 완료된 배지만 대상이 되며, 그 외(회수중, 회수완료 등)의 배지는 오류 없이 제외되고 실제 접수된 건수가 응답에 함께 반환됩니다.

결과 확인

별도의 폴링 전용 엔드포인트는 없습니다.
발급·회수 후 GET /badges/history(발급이력)를 조회하여 발급 상태를 확인할 수 있습니다.

배지의 상태 값 전체 목록과 각 엔드포인트의 요청·응답은 API 문서 보기를 참고하세요.

발급·회수 흐름 ​

발급 ​

회수 ​

결과 확인 ​

발급·회수 흐름

발급

회수

결과 확인