배지 상세 조회

GET

/badges/{badge_id}

badge_id로 배지 상세를 조회합니다. 회수 요청자 구분과 ISSUER의 현재 이름·로그인 ID를 반환합니다. revoke_by가 기록되지 않은 배지는 구분도 null입니다. 운영자 신원과 API 키 접두어는 반환하지 않습니다.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

요청 파라미터

필드명	위치	타입	필수 여부	기본값	설명
badge_id	path	string	Required	-

Responses

배지 상세

Content-Type

application/json

{

  

"code": "0001",

  

"message": "요청 성공하였습니다.",

  

"data": {

  

  

"badge_id": "0QY4B3HP11FHQ",

  

  

"source_cd": "INTERNAL",

  

  

"issuing_org": "미래대학교",

  

  

"company_name": "미래대학교",

  

  

"cert_no": "CERT-463337",

  

  

"title": "창의 부트캠프",

  

  

"category_name": "내부훈련",

  

  

"badge_type_name": "참여",

  

  

"level_name": "중급",

  

  

"description": "창의 부트캠프 배지",

  

  

"criteria": "창의 부트캠프 이수 기준 충족",

  

  

"front_image_url": "https://api.1badge.world/api/v1/public/credentials/0QY4B3HP11FHQ.png",

  

  

"back_image_url": "https://api.1badge.world/api/v1/public/credentials/0QY4B3HP11FHQ_back.png",

  

  

"skills_tag": "협업,문제해결,리더십",

  

  

"status_name": "회수중",

  

  

"recipient_name": "홍길동",

  

  

"recipient_email": "test@1badge.world",

  

  

"email_status": "SENT",

  

  

"valid_from": "2027-01-03 05:36:43",

  

  

"valid_until": null,

  

  

"issued_at": "2027-01-03 05:36:43",

  

  

"revoke_at": "2027-01-08 05:36:43",

  

  

"revoke_reason": "발급 오류 정정",

  

  

"revoke_by_type": "API",

  

  

"revoke_by_name": null,

  

  

"revoke_by_login_id": null

  

}

}

GET

/badges/{badge_id}

Samples