Convenzioni HTTP
Formati, date, PATCH, importi e paginazione validi per tutta l’API.
Regole generali
| Elemento | Regola |
|---|---|
| Autenticazione | Authorization: Bearer <tenant-key>. Nessun X-Tenant-Id: il tenant deriva dalla chiave. |
| Richieste | JSON con Content-Type: application/json; limite 15 MB. I campi sconosciuti vengono ignorati. |
| Date | ISO 8601 con Z o offset esplicito; risposte in UTC. Le ricorrenze usano il fuso IANA del prodotto, altrimenti del fornitore. |
| PATCH | Parziale sui campi documentati. metadata/restrictions sostituiscono l’oggetto precedente. null solo dove ammesso. |
| Risposte | JSON diretto, senza wrapper data. GET/PATCH/PUT/DELETE 200; POST 201, anche confirm/cancel/retry. |
| Importi | Interi nelle unità minori: EUR 2500 = 25,00 EUR. Non inviare 25.00. |
Paginazione
Fornitori, prodotti, risorse e prenotazioni accettano limit da 1 a 100 e offset da 0. Senza limit restituiscono un array e ignorano offset. Con limit restituiscono:
{ "items": [], "total": 0 }Incrementa offset del limit fino a raggiungere total. Le pagine non sono uno snapshot stabile durante scritture concorrenti. Job e audit restituiscono soltanto gli ultimi 200 risultati, senza questa paginazione.
curl "$TAKO_API_URL/api/v1/bookings?supplierId={supplierId}&from=2030-06-01T00:00:00Z&to=2030-06-30T23:59:59Z&limit=100&offset=0" \
-H "Authorization: Bearer $TAKO_API_KEY"Nelle prenotazioni from/to filtrano la partenza, non la creazione o modifica. Altri filtri: status, supplierId, source e search. Codifica i query parameter con URLSearchParams o equivalente.