/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 е включен във всеки план, включително Free (10 събития/месец на Free), така че пътят 403 е достъпен само при работни пространства, в които EPCIS е изключен от поддръжката. Непознато или изтекло id на задача връща 404.
Параметри в пътя
- idзадължително
string
Id-то на задачата за заснемане, върнато от
POST /api/v1/epcis/capture.
Хедъри
- Authorizationзадължително
string
Bearer <token>— илиtp_API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Заявка
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"
}