이력 레코드 추가

POST /traces/:traceId/items/:itemId/records

아이템에 이력 레코드를 온체인에 추가합니다.

요청

경로 파라미터

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

요청 바디

필드	타입	필수	설명
values	string[]	✅	스키마 필드 순서대로 값 배열
memo	string	—	메모

values 배열은 Trace 배포 시 설정한 fieldNames 순서와 일치해야 합니다.

예시

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

TypeScript

const tx = await api('POST', `/traces/${traceId}/items/${itemId}/records`, {
  values: ['전라남도 나주', '(주)한국농산', '운송', '4'],
  memo: '냉장 차량 출발',
});

Python

tx = api('POST', f'/traces/{trace_id}/items/{item_id}/records', {
    'values': ['전라남도 나주', '(주)한국농산', '운송', '4'],
    'memo': '냉장 차량 출발',
})

응답

{
  "success": true,
  "data": {
    "id": "7e83e591-...",
    "type": "add_record",
    "status": "pending",
    "transactionHash": null,
    "from": "0x592C4D1b...",
    "to": "0x4D954CB4...",
    "createdAt": "2024-01-01T00:00:00.000Z",
    "confirmedAt": null
  }
}

트랜잭션 확정 후 웹훅 trace.record_added 이벤트가 발생합니다.