Přejít na obsah
Sursa Developers

Čas a formáty

JSON a text

  • Těla požadavků a odpovědí jsou JSON v kódování UTF-8 s Content-Type: application/json. Nahrávání souborů používá multipart/form-data.
  • Názvy polí a hodnoty výčtů mají tvar snake_case: next_retry_at, index_failed.
  • Chybové zprávy a texty API jsou v angličtině. Texty, které píšete vy, například názvy karet, se vracejí v původním znění, v jakémkoli jazyce.

Časy

Každý čas je časové razítko podle RFC 3339 v UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Novější pole používají krátký tvar se Z jako výše.
  • Některá dříve zavedená pole používají tvar 2026-10-24T10:00:00.123456+00:00 s až šesti číslicemi zlomků sekundy. Jde o stejný okamžik v UTC. Oba tvary zpracujte standardním parserem RFC 3339; časová razítka neporovnávejte jako řetězce.
  • Každé pole, jehož název končí na _at, je časové razítko.

Časy, které odesíláte, musí obsahovat posun časového pásma, buď Z, nebo číselný posun, například +02:00. Čas bez posunu je nejednoznačný a vrátí 422 s kódem validation.failed. Sursa každý přijatý čas převede na UTC.

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

V řetězci dotazu se + musí zapsat jako %2B, jinak se přečte jako mezera. Hodnoty času kódujte pro URL, nebo používejte Z.

Data, doby trvání a počty

DruhTvarPříklad
Datum bez časuYYYY-MM-DD v poli, jehož název končí na _date"due_date": "2026-11-01"
Doba trváníCelé číslo, jednotka je v názvu pole"interval_days": 90, "timeout_seconds": 30
PočetCelé číslo v poli, jehož název končí na _count"part_count": 12
Pravda, nebo nepravdaLogická hodnota pojmenovaná přídavným jménem bez is_"active": true, "sensitive": false

Peněžní částky

Částky ve finančních odpovědích jsou desetinné řetězce, například "1250.00", nikdy čísla s plovoucí desetinnou čárkou, aby se neztratila přesnost. Měna je samostatné pole s kódem ISO 4217, například "EUR". Částky zpracujte desetinným typem svého jazyka.

Identifikátory

ID jsou podle objektu řetězce nebo celá čísla. Viz Identifikátory objektů.

Výčty

Pole s pevnou sadou hodnot, například stav, jsou řetězce. Každý výčet v odpovědi může v pozdější verzi dostat nové hodnoty: s hodnotou, kterou neznáte, zacházejte jako s „jiné“. Viz Verze a kompatibilita.

Null a chybějící pole

  • null znamená „bez hodnoty“: karta bez vlastníka má "owner_id": null.
  • Pole může v odpovědi chybět, pokud se na daný objekt nebo požadavek nevztahuje. Reference API označuje, která pole jsou vždy přítomna.
  • V PATCH si vynechané pole ponechá svou hodnotu. Pole vymažete odesláním null tam, kde reference uvádí, že je null povolené.