API 문서 보기

1Badge API의 전체 엔드포인트를 기능별로 정리했습니다.
각 엔드포인트의 요청·응답 상세는 좌측 목록에서 확인하세요.

모든 요청에는 X-API-Key 헤더가 필요합니다.
Base URL·인증·응답 형식은 REST API 사용 및 에러 안내를 참고하세요.

조회

메서드	엔드포인트	설명
GET	/ping	API Key 인증 확인
GET	/badge-types	배지유형 목록 조회
GET	/categories	카테고리 목록 조회
GET	/categories/{category_id}	카테고리 상세 조회
GET	/badge-templates	배지 템플릿 목록 조회
GET	/badge-templates/{template_id}	배지 템플릿 상세 조회
GET	/badges/history	발급이력 목록 조회
GET	/badges/{badge_id}	배지 상세 조회
GET	/wallet/badges	수령인 보유 배지 조회

발급

발급은 비동기로 처리됩니다. 요청은 202로 접수되며, 결과는 조회로 확인합니다.
자세한 내용은 발급·회수 흐름을 참고하세요.

메서드	엔드포인트	설명
POST	/badges	배지 단건 발급
POST	/badges/batch	배지 일괄 발급 (최대 1,000건)

회수

회수는 비동기로 처리됩니다. 요청은 202로 접수되며, 발급 완료 상태의 배지만 대상이 됩니다.

메서드	엔드포인트	설명
POST	/badges/revoke	배지 일괄 회수 (최대 1,000건)