Hoppa till innehållet
Sursa Developers

Tid och format

JSON och text

  • Anropens och svarens brödtext är JSON i UTF-8, med Content-Type: application/json. Filuppladdningar använder multipart/form-data.
  • Fältnamn och uppräkningsvärden skrivs i snake_case: next_retry_at, index_failed.
  • Felmeddelanden och API:ets texter är på engelska. Texter som du skriver, till exempel kortrubriker, returneras som du skrev dem, på vilket språk som helst.

Tider

Varje tid är en tidsstämpel enligt RFC 3339 i UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Nyare fält använder den korta formen med Z, som ovan.
  • Vissa fält som fanns tidigare använder formen 2026-10-24T10:00:00.123456+00:00, med upp till sex decimaler för bråkdelar av en sekund. Det är samma tidpunkt i UTC. Tolka båda formerna med en vanlig RFC 3339-parser; jämför inte tidsstämplar som strängar.
  • Varje fält vars namn slutar på _at är en tidsstämpel.

Tider som du skickar måste ha en tidszonsförskjutning, antingen Z eller en numerisk förskjutning som +02:00. En tid utan förskjutning är tvetydig och returnerar 422 med koden validation.failed. Sursa konverterar varje tid som den tar emot till UTC.

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

I en frågesträng måste + skrivas som %2B, annars läses det som ett mellanslag. URL-koda tidsvärden eller använd Z.

Datum, varaktigheter och antal

TypFormExempel
Datum utan tidYYYY-MM-DD, i ett fält som slutar på _date"due_date": "2026-11-01"
VaraktighetEtt heltal, med enheten i fältnamnet"interval_days": 90, "timeout_seconds": 30
AntalEtt heltal, i ett fält som slutar på _count"part_count": 12
Sant eller falsktEtt booleskt värde, namngivet med ett adjektiv utan is_"active": true, "sensitive": false

Penningbelopp

Belopp i finansiella svar är decimala strängar, till exempel "1250.00", aldrig flyttal, så att ingen precision går förlorad. Valutan är ett separat fält med en kod enligt ISO 4217, till exempel "EUR". Tolka belopp med en decimaltyp i ditt språk.

Id

Id är strängar eller heltal beroende på objektet. Se Objektens id.

Uppräkningar

Fält med en fast uppsättning värden, till exempel en status, är strängar. Varje uppräkning i ett svar kan få nya värden i en senare version: behandla ett värde som du inte känner till som ”övrigt”. Se Versioner och kompatibilitet.

Null och saknade fält

  • null betyder ”inget värde”: ett kort utan ansvarig har "owner_id": null.
  • Ett fält kan saknas i ett svar när det inte gäller det här objektet eller det här anropet. API-referensen anger vilka fält som alltid finns med.
  • I en PATCH behåller ett fält som du utelämnar sitt värde. Skicka null för att tömma ett fält där referensen säger att null är tillåtet.