Przejdź do treści
Sursa Developers

Czas i formaty

JSON i tekst

  • Treści żądań i odpowiedzi to JSON w UTF-8, z nagłówkiem Content-Type: application/json. Przesyłanie plików używa multipart/form-data.
  • Nazwy pól i wartości wyliczeń są zapisywane w snake_case: next_retry_at, index_failed.
  • Komunikaty błędów i teksty API są po angielsku. Teksty, które piszesz Ty, np. tytuły kart, są zwracane w takiej postaci, w jakiej je zapisano, w dowolnym języku.

Czas

Każdy czas to znacznik czasu RFC 3339 w UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Nowsze pola używają krótkiej formy z Z, jak powyżej.
  • Niektóre pola istniejące wcześniej używają formy 2026-10-24T10:00:00.123456+00:00, z maksymalnie sześcioma cyframi ułamka sekundy. To ten sam moment w UTC. Parsuj obie formy standardowym parserem RFC 3339; nie porównuj znaczników czasu jako ciągów znaków.
  • Każde pole, którego nazwa kończy się na _at, jest znacznikiem czasu.

Wysyłany czas musi zawierać przesunięcie strefy czasowej: Z albo przesunięcie liczbowe, np. +02:00. Czas bez przesunięcia jest niejednoznaczny i zwraca 422 z kodem validation.failed. Sursa przelicza każdy otrzymany czas na UTC.

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

W ciągu zapytania znak + trzeba zapisać jako %2B, w przeciwnym razie zostanie odczytany jako spacja. Koduj wartości czasu do postaci URL albo używaj Z.

Daty, czasy trwania i liczniki

RodzajFormaPrzykład
Data bez godzinyYYYY-MM-DD, w polu kończącym się na _date"due_date": "2026-11-01"
Czas trwaniaLiczba całkowita, jednostka w nazwie pola"interval_days": 90, "timeout_seconds": 30
LicznikLiczba całkowita, w polu kończącym się na _count"part_count": 12
Prawda lub fałszWartość logiczna nazwana przymiotnikiem, bez is_"active": true, "sensitive": false

Kwoty pieniężne

Kwoty w odpowiedziach finansowych to dziesiętne ciągi znaków, np. "1250.00", nigdy liczby zmiennoprzecinkowe, dzięki czemu nie traci się precyzji. Waluta jest osobnym polem z kodem ISO 4217, np. "EUR". Parsuj kwoty typem dziesiętnym w swoim języku programowania.

Identyfikatory

Identyfikatory są ciągami znaków lub liczbami całkowitymi, zależnie od obiektu. Zob. Identyfikatory obiektów.

Wyliczenia

Pola o stałym zbiorze wartości, np. status, są ciągami znaków. Każde wyliczenie w odpowiedzi może otrzymać nowe wartości w późniejszej wersji: wartość, której nie znasz, traktuj jak „inną”. Zob. Wersje i zgodność.

Wartość null i brakujące pola

  • null oznacza „brak wartości”: karta bez właściciela ma "owner_id": null.
  • Pole może nie występować w odpowiedzi, gdy nie dotyczy tego obiektu lub tego żądania. Dokumentacja API oznacza, które pola są zawsze obecne.
  • W żądaniu PATCH pominięte pole zachowuje swoją wartość. Wyślij null, aby wyczyścić pole, jeśli dokumentacja podaje, że null jest dozwolone.