본문으로 건너뛰기

발급 이력 조회

이력 목록​

GET /certificates/:certificateId/items

쿼리 파라미터

파라미터타입기본값설명
pagenumber1페이지 번호
limitnumber20페이지당 항목 수
searchstring—지갑 주소 또는 tokenId 검색

응답 예시

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "3b6540fc-6f67-4a10-a660-a0de50e7975e",
        "certificateId": "8ce493b5-...",
        "action": "issued",
        "from": null,
        "to": "0x1111111111111111111111111111111111111111",
        "tokenId": "1",
        "amount": null,
        "tokenUri": "https://kbaas-storage.kr.object.gov-ncloudstorage.com/certificates/.../metadata.json",
        "imageUri": "https://kbaas-storage.kr.object.gov-ncloudstorage.com/certificates/.../certificate.png",
        "imageHash": "94d24ce16470e85b9fcb41de06b3009cc835ad1138f8012845e6ab99d007dd6c",
        "transactionHash": "0xd97fc363...",
        "createdAt": "2024-01-01T00:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

응답 필드

필드설명
actionissued (발급) / revoked (폐기)
tokenUri메타데이터 JSON URL (tokenUri가 없으면 인증서 공통 URI 반환)
imageUri이미지 스토리지 URL (이미지 첨부 발급 시에만)
imageHash이미지 SHA-256 해시 (진본 확인용)

이력 단건 조회​

GET /certificates/:certificateId/items/:itemId

itemId(UUID) 또는 txHash로 특정 발급 이력을 조회합니다.

// itemId로 조회
const item = await api('GET', `/certificates/${certificateId}/items/${itemId}`);

// txHash로 조회
const item = await api('GET', `/certificates/${certificateId}/items/${txHash}`);