Preskočiť na obsah
Sursa Developers

Čas a formáty

JSON a text

  • Telá požiadaviek a odpovedí sú JSON v kódovaní UTF-8 s Content-Type: application/json. Nahrávanie súborov používa multipart/form-data.
  • Názvy polí a hodnoty výčtov sú v tvare snake_case: next_retry_at, index_failed.
  • Chybové správy a texty API sú v angličtine. Texty, ktoré napíšete vy, napríklad názvy kariet, sa vracajú tak, ako ste ich napísali, v ľubovoľnom jazyku.

Časy

Každý čas je časová značka RFC 3339 v UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Novšie polia používajú krátky tvar so Z ako v ukážke.
  • Niektoré staršie polia používajú tvar 2026-10-24T10:00:00.123456+00:00 s najviac šiestimi desatinnými miestami sekúnd. Ide o rovnaký okamih v UTC. Oba tvary spracujte štandardným parserom RFC 3339; časové značky neporovnávajte ako reťazce.
  • Každé pole, ktorého názov končí na _at, je časová značka.

Časy, ktoré odosielate, musia obsahovať posun časového pásma: buď Z, alebo číselný posun, napríklad +02:00. Čas bez posunu je nejednoznačný a vráti 422 s kódom validation.failed. Sursa každý prijatý čas prevedie na UTC.

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

V reťazci dotazu treba + zapísať ako %2B, inak sa prečíta ako medzera. Hodnoty času kódujte pre URL alebo použite Z.

Dátumy, trvania a počty

DruhTvarPríklad
Dátum bez časuYYYY-MM-DD v poli, ktoré končí na _date"due_date": "2026-11-01"
TrvanieCelé číslo, jednotka je v názve poľa"interval_days": 90, "timeout_seconds": 30
PočetCelé číslo v poli, ktoré končí na _count"part_count": 12
Áno alebo nieLogická hodnota pomenovaná prídavným menom bez is_"active": true, "sensitive": false

Peňažné sumy

Sumy vo finančných odpovediach sú desatinné reťazce, napríklad "1250.00", nikdy nie čísla s pohyblivou desatinnou čiarkou, aby sa nestratila presnosť. Mena je samostatné pole s kódom podľa ISO 4217, napríklad "EUR". Sumy spracúvajte desatinným typom vo svojom jazyku.

Identifikátory

Identifikátory sú podľa objektu reťazce alebo celé čísla. Pozri Identifikátory objektov.

Výčty

Polia s pevnou množinou hodnôt, napríklad stav, sú reťazce. Každý výčet v odpovedi môže v neskoršej verzii dostať nové hodnoty: hodnotu, ktorú nepoznáte, považujte za „iné“. Pozri Verzie a kompatibilita.

Null a chýbajúce polia

  • null znamená „bez hodnoty“: karta bez vlastníka má "owner_id": null.
  • Pole môže v odpovedi chýbať, keď sa na tento objekt alebo túto požiadavku nevzťahuje. Ktoré polia sú vždy prítomné, vyznačuje referencia API.
  • V požiadavke PATCH si pole, ktoré vynecháte, zachová hodnotu. Ak chcete pole vymazať, odošlite null tam, kde referencia uvádza, že null je povolené.