/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 a pagamento oggi, quindi il percorso 403 è raggiungibile solo su spazi di lavoro il cui flag `epcisCaptureEnabled` è stato disabilitato tramite override per tenant. 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 API `tp_` (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"
}