Vai al contenuto
Sursa Developers

Orari e formati

JSON e testo

  • I corpi delle richieste e delle risposte sono JSON in UTF-8, con Content-Type: application/json. I caricamenti di file usano multipart/form-data.
  • I nomi dei campi e i valori delle enumerazioni sono in snake_case: next_retry_at, index_failed.
  • I messaggi di errore e i testi dell’API sono in inglese. I testi che scrivi tu, come i titoli delle schede, vengono restituiti così come li hai scritti, in qualsiasi lingua.

Orari

Ogni orario è un timestamp RFC 3339 in UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • I campi più recenti usano la forma breve con Z, come sopra.
  • Alcuni campi che esistevano già usano la forma 2026-10-24T10:00:00.123456+00:00, con fino a sei cifre di frazioni di secondo. È lo stesso istante in UTC. Analizza entrambe le forme con un parser RFC 3339 standard; non confrontare i timestamp come stringhe.
  • Ogni campo il cui nome termina con _at è un timestamp.

Gli orari che invii devono includere uno scostamento dal fuso orario, Z oppure uno scostamento numerico come +02:00. Un orario senza scostamento è ambiguo e restituisce 422 con il codice validation.failed. Sursa converte in UTC ogni orario che riceve.

const since = new Date(Date.now() - 24 * 3600 * 1000).toISOString(); // "2026-10-23T10:00:00.000Z"

In una query string, un + va scritto come %2B, altrimenti viene letto come uno spazio. Codifica per URL i valori degli orari, oppure usa Z.

Date, durate e conteggi

TipoFormaEsempio
Data senza orarioYYYY-MM-DD, in un campo che termina con _date"due_date": "2026-11-01"
DurataUn intero, con l’unità nel nome del campo"interval_days": 90, "timeout_seconds": 30
ConteggioUn intero, in un campo che termina con _count"part_count": 12
Vero o falsoUn booleano, con un aggettivo come nome e senza is_"active": true, "sensitive": false

Importi

Gli importi nelle risposte finanziarie sono stringhe decimali, come "1250.00", mai numeri in virgola mobile, così non si perde precisione. La valuta è un campo separato con un codice ISO 4217, come "EUR". Analizza gli importi con un tipo decimale del tuo linguaggio.

ID

Gli ID sono stringhe o interi a seconda dell’oggetto. Vedi ID degli oggetti.

Enumerazioni

I campi con un insieme fisso di valori, come uno stato, sono stringhe. Ogni enumerazione in una risposta può ricevere nuovi valori in una versione successiva: tratta un valore che non conosci come “altro”. Vedi Versioni e compatibilità.

Campi null e mancanti

  • null significa “nessun valore”: una scheda senza responsabile ha "owner_id": null.
  • Un campo può mancare in una risposta quando non si applica a questo oggetto o a questa richiesta. Il riferimento API indica quali campi sono sempre presenti.
  • In un PATCH, un campo che ometti mantiene il suo valore. Invia null per svuotare un campo, dove il riferimento dice che null è ammesso.