Salt la conținut
Sursa Developers

Timp și formate

JSON și text

  • Corpurile cererilor și ale răspunsurilor sunt JSON în UTF-8, cu Content-Type: application/json. Încărcările de fișiere folosesc multipart/form-data.
  • Numele câmpurilor și valorile de enumerare sunt în snake_case: next_retry_at, index_failed.
  • Mesajele de eroare și textele API-ului sunt în engleză. Textele scrise de dumneavoastră, cum ar fi titlurile fișelor, sunt returnate exact cum le-ați scris, în orice limbă.

Momente de timp

Fiecare moment este un marcaj de timp RFC 3339 în UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Câmpurile mai noi folosesc forma scurtă cu Z, ca mai sus.
  • Unele câmpuri care existau mai devreme folosesc forma 2026-10-24T10:00:00.123456+00:00, cu cel mult șase cifre pentru fracțiunile de secundă. Este același moment în UTC. Analizați ambele forme cu un parser RFC 3339 standard; nu comparați marcajele de timp ca șiruri.
  • Fiecare câmp al cărui nume se termină în _at este un marcaj de timp.

Momentele pe care le trimiteți trebuie să includă decalajul fusului orar, fie Z, fie un decalaj numeric, de exemplu +02:00. Un moment fără decalaj este ambiguu și returnează 422 cu codul validation.failed. Sursa convertește în UTC fiecare moment pe care îl primește.

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

Într-un șir de interogare, + trebuie scris ca %2B, altfel este citit ca spațiu. Codificați pentru URL valorile de timp sau folosiți Z.

Date calendaristice, durate și numărători

TipFormăExemplu
Dată fără orăYYYY-MM-DD, într-un câmp care se termină în _date"due_date": "2026-11-01"
DuratăUn număr întreg, cu unitatea în numele câmpului"interval_days": 90, "timeout_seconds": 30
NumărătoareUn număr întreg, într-un câmp care se termină în _count"part_count": 12
Adevărat sau falsO valoare booleană, numită printr-un adjectiv fără is_"active": true, "sensitive": false

Sume de bani

Sumele din răspunsurile financiare sunt șiruri zecimale, de exemplu "1250.00", niciodată numere în virgulă mobilă, ca să nu se piardă precizie. Moneda este un câmp separat, cu un cod ISO 4217, de exemplu "EUR". Analizați sumele cu un tip zecimal din limbajul folosit.

Identificatori

Identificatorii sunt șiruri sau numere întregi, în funcție de obiect. Vedeți Identificatorii obiectelor.

Enumerări

Câmpurile cu un set fix de valori, cum ar fi un status, sunt șiruri. Orice enumerare dintr-un răspuns poate primi valori noi într-o versiune ulterioară: tratați o valoare necunoscută ca „altceva”. Vedeți Versiuni și compatibilitate.

Câmpuri null și câmpuri lipsă

  • null înseamnă „nicio valoare”: o fișă fără responsabil are "owner_id": null.
  • Un câmp poate lipsi dintr-un răspuns când nu se aplică acestui obiect sau acestei cereri. Referința API marchează câmpurile care sunt prezente întotdeauna.
  • Într-un PATCH, un câmp omis își păstrează valoarea. Trimiteți null pentru a goli un câmp acolo unde referința spune că null este permis.