/api/v1/epcis/capture/{id}Interrogare un job di acquisizione
Legge lo stato di un job di acquisizione EPCIS asincrono — il lato di lettura del modello di acquisizione EPCIS 2.0. POST /api/v1/epcis/capture restituisce 202 Accepted con un captureJobId; passate quell'id qui per seguire il job fino a uno stato terminale.
La risposta porta status, l'eventCount inviato, il capturedCount memorizzato finora e un array errors per evento ({index, message}) per gli eventi che non hanno superato la convalida o la risoluzione degli EPC. createdAt e finishedAt racchiudono l'esecuzione — finishedAt è null mentre il job è ancora in corso. Conta come una lettura.
Gate del piano: EPCIS è incluso in ogni piano, Free compreso (10 eventi/mese su Free), quindi il percorso 403 è raggiungibile solo su spazi di lavoro in cui l'assistenza ha disattivato EPCIS. Un id di job sconosciuto o scaduto restituisce 404.
Parametri di percorso
- idobbligatorio
string
L'id del job di acquisizione restituito da
POST /api/v1/epcis/capture.
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Richiesta
curl -sS https://app.tracepass.eu/api/v1/epcis/capture/6650c4d5e6f7a8b9c0d1e2f3 \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Risposta
{
"captureJobId": "6650c4d5e6f7a8b9c0d1e2f3",
"status": "success",
"eventCount": 12,
"capturedCount": 12,
"errors": [],
"createdAt": "2026-05-09T12:00:00.000Z",
"finishedAt": "2026-05-09T12:00:03.420Z"
}