본문으로 건너뛰기

이력 조회

GET /traces/:traceId/items/:itemId/history

특정 아이템에 기록된 이력 레코드 목록을 시간순으로 조회합니다.

경로 파라미터

파라미터설명
traceId이력관리 컨트랙트 ID
itemId아이템 UUID (아이템 목록 조회 응답의 id 필드)

쿼리 파라미터​

파라미터타입기본값설명
pagenumber1페이지 번호
limitnumber20페이지당 항목 수

응답 예시​

스키마 ["생산지", "담당업체", "유통단계", "보관온도"] 기준:

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "26514429-...",
        "traceItemId": "74951695-...",
        "values": ["전라남도 나주", "(주)한국농산", "생산", "20"],
        "memo": "출하 준비",
        "transactionHash": "0x9b003c18...",
        "createdAt": "2024-01-01T08:00:00.000Z"
      },
      {
        "id": "771daeba-...",
        "traceItemId": "74951695-...",
        "values": ["전라남도 나주", "(주)한국농산", "운송", "4"],
        "memo": "냉장 차량 출발",
        "transactionHash": "0x6f95f930...",
        "createdAt": "2024-01-01T10:00:00.000Z"
      }
    ],
    "total": 2,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}
const history = await api('GET', `/traces/${traceId}/items/${itemId}/history`);

전체 이력 흐름 예시​

아이템 생성 (PRODUCT-2024-001)
  ↓
레코드 1: 생산 단계 기록 (온도: 20°C)
  ↓
레코드 2: 운송 단계 기록 (온도: 4°C)
  ↓
레코드 3: 판매 단계 기록 (온도: 5°C)

각 레코드는 블록체인 트랜잭션으로 영구 기록되며 위변조가 불가능합니다.