아이템 목록 조회
GET /traces/:traceId/items
쿼리 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
page | number | 1 | 페이지 번호 |
limit | number | 20 | 페이지당 항목 수 |
search | string | — | externalId 검색 |
응답 예시
{
"success": true,
"data": {
"items": [
{
"id": "74951695-b7fa-44fd-ad95-3a7dbb56aab9",
"traceId": "34956089-...",
"onChainItemId": 0,
"externalId": "PRODUCT-2024-001",
"metadata": "{\"lot\":\"A123\"}",
"createdTxHash": "0x44d54339...",
"recordCount": 3,
"createdAt": "2024-01-01T00:00:00.000Z"
}
],
"total": 1,
"page": 1,
"limit": 20,
"totalPages": 1
}
}
아이템 단건 조회, 이력 레코드 추가, 이력 조회 시 응답의 id (UUID)를 경로 파라미터로 사용합니다.