아이템 생성

POST /traces/:traceId/items

추적 대상 아이템을 온체인에 등록합니다.

요청 바디

필드	타입	필수	설명
externalId	string	✅	외부 시스템 연동 ID (예: 제품 바코드, 주문번호)
metadata	string	—	메타데이터 JSON 문자열

TypeScript

const tx = await api('POST', `/traces/${traceId}/items`, {
  externalId: 'PRODUCT-2024-001',
  metadata: JSON.stringify({ lot: 'A123', origin: '전라남도' }),
});

Python

import json

tx = api('POST', f'/traces/{trace_id}/items', {
    'externalId': 'PRODUCT-2024-001',
    'metadata': json.dumps({'lot': 'A123', 'origin': '전라남도'}),
})

응답

{
  "success": true,
  "data": {
    "id": "fd89036f-...",
    "type": "create_item",
    "status": "pending",
    "txHash": null,
    "from": "0x592C4D1b...",
    "to": "0x4D954CB4...",
    "contractId": "34956089-...",
    "createdAt": "2024-01-01T00:00:00.000Z",
    "confirmedAt": null
  }
}

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