/api/v1/passports/batchCreazione massiva di passaporti
Create fino a 100 passaporti in una sola chiamata. Ogni elemento porta la stessa forma del corpo dell'endpoint di creazione singola (`{ productId, gs1: { gtin, serialNumber }, parties?, confirmOverage? }`). Successo parziale per elemento — ognuno ottiene il proprio stato nell'array di risposta.
L'intero lotto consuma in anticipo N scritture rispetto al vostro budget di scrittura giornaliero; se ciò provocasse uno sforamento, l'intero lotto restituisce 429 (nessun addebito parziale). Lo stesso vale per il flusso di eccedenza DPP a livello di lotto — quando la quota DPP verrebbe superata, il lotto restituisce 402 con `overage_required` e `confirmOverage: true` accetta l'addebito di eccedenza per l'intero lotto.
Idempotency-Key si applica all'intero lotto — riproporre la stessa chiave restituisce l'array di risultati completo originale. Il limite è di 100 elementi per chiamata (corrisponde al tetto dei lotti di Stripe così che le risposte a successo parziale restino gestibili).
Header
- Authorizationobbligatorio
string
`Bearer <api-key>`.
- Idempotency-Key
string
UUID v4 — si applica all'intero lotto.
Campi del corpo
- passportsobbligatorio
Array<CreatePassportInput> (1-100)
1–100 oggetti passaporto, ciascuno nella forma del corpo di creazione singola.
Richiesta
curl -sS -X POST https://app.tracepass.eu/api/v1/passports/batch \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
-H "Idempotency-Key: 7b4f1e2c-9a3d-4e5b-8c1a-2d3e4f5a6b7c" \
-H "Content-Type: application/json" \
-d '{
"passports": [
{ "productId": "6650a1b2c3d4e5f6a7b8c9d0", "gs1": { "gtin": "04012345000015", "serialNumber": "BP-48V-100-000001" } },
{ "productId": "6650a1b2c3d4e5f6a7b8c9d0", "gs1": { "gtin": "04012345000015", "serialNumber": "BP-48V-100-000002" } },
{ "productId": "6650a1b2c3d4e5f6a7b8c9d0", "gs1": { "gtin": "04012345000015", "serialNumber": "BP-48V-100-000003" } }
]
}'Risposta
{
"results": [
{ "index": 0, "status": "created", "data": { "_id": "...", "gs1": { "...": "..." }, "status": "draft" } },
{ "index": 1, "status": "error", "error": "Serial number already exists for this GTIN" },
{ "index": 2, "status": "created", "data": { "...": "..." } }
],
"summary": { "created": 2, "errors": 1, "total": 3 }
}