Zum Inhalt springen
Sursa Developers

Zeit und Formate

JSON und Text

  • Bodys von Anfragen und Antworten sind JSON in UTF-8, mit Content-Type: application/json. Datei-Uploads verwenden multipart/form-data.
  • Feldnamen und Enum-Werte sind in snake_case geschrieben: next_retry_at, index_failed.
  • Fehlermeldungen und die Texte der API sind auf Englisch. Texte, die Sie selbst schreiben, etwa Kartentitel, werden so zurückgegeben, wie Sie sie geschrieben haben, in jeder Sprache.

Zeitangaben

Jede Zeitangabe ist ein Zeitstempel nach RFC 3339 in UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Neuere Felder verwenden die Kurzform mit Z, wie oben.
  • Einige ältere Felder verwenden die Form 2026-10-24T10:00:00.123456+00:00 mit bis zu sechs Nachkommastellen für Sekundenbruchteile. Es ist derselbe Zeitpunkt in UTC. Lesen Sie beide Formen mit einem standardmäßigen RFC-3339-Parser ein; vergleichen Sie Zeitstempel nicht als Zeichenketten.
  • Jedes Feld, dessen Name auf _at endet, ist ein Zeitstempel.

Zeitangaben, die Sie senden, müssen einen Zeitzonen-Offset enthalten, entweder Z oder einen numerischen Offset wie +02:00. Eine Zeitangabe ohne Offset ist mehrdeutig und ergibt 422 mit dem Code validation.failed. Sursa rechnet jede empfangene Zeitangabe in UTC um.

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

In einem Query-String muss ein + als %2B geschrieben werden, sonst wird es als Leerzeichen gelesen. Kodieren Sie Zeitwerte für die URL oder verwenden Sie Z.

Datumsangaben, Dauern und Anzahlen

ArtFormBeispiel
Datum ohne UhrzeitYYYY-MM-DD, in einem Feld, das auf _date endet"due_date": "2026-11-01"
DauerEine ganze Zahl, die Einheit steht im Feldnamen"interval_days": 90, "timeout_seconds": 30
AnzahlEine ganze Zahl, in einem Feld, das auf _count endet"part_count": 12
Wahr oder falschEin Boolean, benannt mit einem Adjektiv ohne is_"active": true, "sensitive": false

Geldbeträge

Beträge in Finanzantworten sind dezimale Zeichenketten wie "1250.00", niemals Gleitkommazahlen, damit keine Genauigkeit verloren geht. Die Währung steht in einem eigenen Feld mit einem Code nach ISO 4217, etwa "EUR". Lesen Sie Beträge in Ihrer Sprache mit einem Dezimaltyp ein.

IDs

IDs sind je nach Objekt Zeichenketten oder ganze Zahlen. Siehe Objekt-IDs.

Aufzählungen

Felder mit einer festen Wertemenge, etwa ein Status, sind Zeichenketten. Jede Aufzählung in einer Antwort kann in einer späteren Version neue Werte bekommen: Behandeln Sie einen Wert, den Sie nicht kennen, als „Sonstiges“. Siehe Versionen und Kompatibilität.

Null und fehlende Felder

  • null bedeutet „kein Wert“: Eine Karte ohne verantwortliche Person hat "owner_id": null.
  • Ein Feld kann in einer Antwort fehlen, wenn es für dieses Objekt oder diese Anfrage nicht zutrifft. Die API-Referenz kennzeichnet, welche Felder immer vorhanden sind.
  • Bei einem PATCH behält ein Feld, das Sie weglassen, seinen Wert. Senden Sie null, um ein Feld zu leeren, wenn die Referenz angibt, dass null erlaubt ist.