TracePass
EPCIS 2.0

Заявяване на задача за заснемане

Прочита статуса на асинхронна задача за заснемане на EPCIS — четящата страна на модела за заснемане на EPCIS 2.0. `POST /api/v1/epcis/capture` връща `202 Accepted` с `captureJobId`; подайте това id тук, за да проследите задачата, докато достигне крайно състояние.

GET/api/v1/epcis/capture/{id}
Изтегли OpenAPI 3.1
GET/api/v1/epcis/capture/{id}

Заявяване на задача за заснемане

Прочита статуса на асинхронна задача за заснемане на EPCIS — четящата страна на модела за заснемане на EPCIS 2.0. `POST /api/v1/epcis/capture` връща `202 Accepted` с `captureJobId`; подайте това id тук, за да проследите задачата, докато достигне крайно състояние.

Отговорът носи `status`, изпратения `eventCount`, `capturedCount` съхранени досега и масив `errors` на всяко събитие (`{index, message}`) за събитията, които не са преминали валидация или съпоставяне на EPC. `createdAt` и `finishedAt` ограждат изпълнението — `finishedAt` е `null`, докато задачата все още е в ход. Брои се като едно четене.

Гейт на плана: EPCIS е включен във всеки платен план днес, така че пътят 403 е достъпен само при работни пространства, чийто флаг `epcisCaptureEnabled` е изключен чрез per-tenant override. Непознато или изтекло id на задача връща `404`.

Параметри в пътя

  • idзадължително

    string

    Id-то на задачата за заснемане, върнато от `POST /api/v1/epcis/capture`.

Хедъри

  • Authorizationзадължително

    string

    `Bearer <api-key>`.

Заявка

curl -sS https://app.tracepass.eu/api/v1/epcis/capture/6650c4d5e6f7a8b9c0d1e2f3 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "captureJobId": "6650c4d5e6f7a8b9c0d1e2f3",
  "status": "success",
  "eventCount": 12,
  "capturedCount": 12,
  "errors": [],
  "createdAt": "2026-05-09T12:00:00.000Z",
  "finishedAt": "2026-05-09T12:00:03.420Z"
}