Pāriet uz saturu
Sursa Developers

Laiks un formāti

JSON un teksts

  • Pieprasījumu un atbilžu saturs ir JSON kodējumā UTF-8 ar Content-Type: application/json. Failu augšupielādei izmanto multipart/form-data.
  • Lauku nosaukumi un uzskaitījumu vērtības ir formā snake_case: next_retry_at, index_failed.
  • Kļūdu ziņojumi un API teksti ir angļu valodā. Jūsu rakstītie teksti, piemēram, kartīšu virsraksti, tiek atgriezti tādi, kādus jūs tos uzrakstījāt, jebkurā valodā.

Laiki

Katrs laiks ir RFC 3339 laika zīmogs UTC laikā:

{"created_at": "2026-10-24T10:00:00Z"}
  • Jaunākie lauki izmanto īso formu ar Z, kā iepriekš.
  • Daži agrāk ieviesti lauki izmanto formu 2026-10-24T10:00:00.123456+00:00 ar līdz sešiem sekundes daļu cipariem. Tas ir tas pats brīdis UTC laikā. Abas formas parsējiet ar standarta RFC 3339 parsētāju; nesalīdziniet laika zīmogus kā virknes.
  • Katrs lauks, kura nosaukums beidzas ar _at, ir laika zīmogs.

Laikos, ko sūtāt, jābūt laika joslas nobīdei – vai nu Z, vai skaitliskai nobīdei, piemēram, +02:00. Laiks bez nobīdes ir neviennozīmīgs un atgriež 422 ar kodu validation.failed. Sursa katru saņemto laiku pārvērš UTC laikā.

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

Vaicājuma virknē + jāraksta kā %2B, citādi to nolasa kā atstarpi. Laika vērtības kodējiet URL kodējumā vai izmantojiet Z.

Datumi, ilgumi un skaiti

VeidsFormaPiemērs
Datums bez laikaYYYY-MM-DD laukā, kura nosaukums beidzas ar _date"due_date": "2026-11-01"
IlgumsVesels skaitlis, mērvienība ir lauka nosaukumā"interval_days": 90, "timeout_seconds": 30
SkaitsVesels skaitlis laukā, kura nosaukums beidzas ar _count"part_count": 12
Patiess vai nepatiessBūla vērtība, kuras nosaukums ir īpašības vārds bez is_"active": true, "sensitive": false

Naudas summas

Summas finanšu atbildēs ir decimālskaitļu virknes, piemēram, "1250.00", nekad ne peldošā punkta skaitļi, lai nezustu precizitāte. Valūta ir atsevišķs lauks ar ISO 4217 kodu, piemēram, "EUR". Summas parsējiet ar savas programmēšanas valodas decimālskaitļu tipu.

ID

ID ir virknes vai veseli skaitļi atkarībā no objekta. Sk. Objektu ID.

Uzskaitījumi

Lauki ar fiksētu vērtību kopu, piemēram, statuss, ir virknes. Jebkurš uzskaitījums atbildē nākamajā versijā var iegūt jaunas vērtības: vērtību, ko nepazīstat, uztveriet kā „cita“. Sk. Versijas un saderība.

Null un trūkstoši lauki

  • null nozīmē „nav vērtības“: kartītei bez atbildīgās personas ir "owner_id": null.
  • Lauka atbildē var nebūt, ja tas neattiecas uz šo objektu vai šo pieprasījumu. API rokasgrāmatā ir atzīmēts, kuri lauki ir vienmēr.
  • PATCH pieprasījumā izlaists lauks saglabā savu vērtību. Lai notīrītu lauku, nosūtiet null, ja rokasgrāmatā teikts, ka null ir atļauts.