Ugrás a tartalomra
Sursa Developers

Időpontok és formátumok

JSON és szöveg

  • A kéréstörzsek és a választörzsek UTF-8 kódolású JSON-ok, Content-Type: application/json fejléccel. A fájlfeltöltések multipart/form-data formátumot használnak.
  • A mezőnevek és az enumértékek snake_case alakúak: next_retry_at, index_failed.
  • A hibaüzenetek és az API szövegei angolok. Az általad írt szövegeket, például a kártyák címét, a Sursa úgy adja vissza, ahogy megírtad őket, bármilyen nyelven.

Időpontok

Minden időpont UTC szerinti RFC 3339 időbélyeg:

{"created_at": "2026-10-24T10:00:00Z"}
  • Az újabb mezők a Z betűs rövid alakot használják, mint fent.
  • Néhány korábban is létező mező a 2026-10-24T10:00:00.123456+00:00 alakot használja, legfeljebb hat tizedesjegynyi másodpercrésszel. Ez ugyanaz az UTC szerinti pillanat. Mindkét alakot szabványos RFC 3339-elemzővel dolgozd fel; az időbélyegeket ne karakterláncként hasonlítsd össze.
  • Minden _at végű nevű mező időbélyeg.

Az általad küldött időpontoknak tartalmazniuk kell az időzóna eltolását: vagy Z betűt, vagy számszerű eltolást, például +02:00 értéket. Az eltolás nélküli időpont nem egyértelmű, és 422 választ kap a validation.failed kóddal. A Sursa minden kapott időpontot UTC-re alakít.

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

A lekérdezési karakterláncban a + jelet %2B alakban kell írni, különben szóköznek olvassa a rendszer. Az időértékeket URL-kódold, vagy használd a Z betűt.

Dátumok, időtartamok és darabszámok

FajtaAlakPélda
Dátum időpont nélkülYYYY-MM-DD, _date végű mezőben"due_date": "2026-11-01"
IdőtartamEgész szám, a mértékegység a mező nevében"interval_days": 90, "timeout_seconds": 30
DarabszámEgész szám, _count végű mezőben"part_count": 12
Igaz vagy hamisLogikai érték, is_ nélküli melléknévvel elnevezve"active": true, "sensitive": false

Pénzösszegek

A pénzügyi válaszokban az összegek tizedes karakterláncok, például "1250.00", soha nem lebegőpontos számok, hogy ne vesszen el a pontosság. A pénznem külön mező ISO 4217 szerinti kóddal, például "EUR". Az összegeket a programozási nyelved decimális típusával dolgozd fel.

Azonosítók

Az azonosítók az objektumtól függően karakterláncok vagy egész számok. Lásd: Objektumazonosítók.

Felsorolások

A rögzített értékkészletű mezők, például az állapot, karakterláncok. A válaszok minden felsorolása új értékeket kaphat egy későbbi verzióban: az ismeretlen értéket kezeld „egyéb” értékként. Lásd: Verziók és kompatibilitás.

Null és hiányzó mezők

  • A null jelentése „nincs érték”: a felelős nélküli kártyánál "owner_id": null áll.
  • Egy mező hiányozhat a válaszból, ha nem vonatkozik erre az objektumra vagy erre a kérésre. Az API-referencia jelöli, mely mezők vannak mindig jelen.
  • PATCH kérésben a kihagyott mező megtartja az értékét. Ha egy mezőt törölni szeretnél, küldj null értéket ott, ahol a referencia szerint a null megengedett.