Preskoči na sadržaj
Sursa Developers

Vrijeme i formati

JSON i tekst

  • Tijela zahtjeva i odgovora su JSON u kodiranju UTF-8, sa zaglavljem Content-Type: application/json. Učitavanja datoteka koriste multipart/form-data.
  • Imena polja i vrijednosti nabrajanja pišu se u obliku snake_case: next_retry_at, index_failed.
  • Poruke o pogreškama i tekstovi API-ja su na engleskom. Tekstovi koje sami napišete, kao što su naslovi kartica, vraćaju se onako kako ste ih napisali, na bilo kojem jeziku.

Vrijeme

Svako je vrijeme vremenska oznaka u formatu RFC 3339 u UTC-u:

{"created_at": "2026-10-24T10:00:00Z"}
  • Novija polja koriste kratki oblik sa Z, kao gore.
  • Neka polja koja su postojala ranije koriste oblik 2026-10-24T10:00:00.123456+00:00, s do šest znamenki dijelova sekunde. Riječ je o istom trenutku u UTC-u. Oba oblika raščlanjujte standardnim parserom za RFC 3339; vremenske oznake ne uspoređujte kao nizove znakova.
  • Svako polje čije ime završava na _at vremenska je oznaka.

Vrijeme koje šaljete mora sadržavati pomak vremenske zone, bilo Z bilo brojčani pomak kao što je +02:00. Vrijeme bez pomaka je dvosmisleno i vraća 422 s kodom validation.failed. Sursa svako primljeno vrijeme pretvara u UTC.

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

U nizu upita znak + mora se napisati kao %2B, inače se čita kao razmak. Vrijednosti vremena kodirajte za URL ili koristite Z.

Datumi, trajanja i brojevi

VrstaOblikPrimjer
Datum bez vremenaYYYY-MM-DD, u polju koje završava na _date"due_date": "2026-11-01"
TrajanjeCijeli broj, s jedinicom u imenu polja"interval_days": 90, "timeout_seconds": 30
Broj stavkiCijeli broj, u polju koje završava na _count"part_count": 12
Istina ili lažLogička vrijednost, imenovana pridjevom bez is_"active": true, "sensitive": false

Novčani iznosi

Iznosi u financijskim odgovorima su decimalni nizovi znakova, kao što je "1250.00", a nikada brojevi s pomičnim zarezom, kako se ne bi izgubila preciznost. Valuta je zasebno polje s kodom prema ISO 4217, kao što je "EUR". Iznose raščlanjujte decimalnim tipom svojeg jezika.

Identifikatori

Identifikatori su nizovi znakova ili cijeli brojevi, ovisno o objektu. V. Identifikatori objekata.

Nabrajanja

Polja s nepromjenjivim skupom vrijednosti, kao što je status, nizovi su znakova. Svako nabrajanje u odgovoru može u kasnijoj verziji dobiti nove vrijednosti: nepoznatu vrijednost tretirajte kao „ostalo”. V. Verzije i kompatibilnost.

Null i polja koja nedostaju

  • null znači „nema vrijednosti”: kartica bez vlasnika ima "owner_id": null.
  • Polje može nedostajati u odgovoru kad se ne odnosi na ovaj objekt ili ovaj zahtjev. Referenca API-ja označava koja su polja uvijek prisutna.
  • U zahtjevu PATCH polje koje izostavite zadržava svoju vrijednost. Pošaljite null da biste ispraznili polje kod kojeg referenca navodi da je null dopušten.