Allgemeine Information
Die GoliathAPI bietet die Möglichkeit von außen Daten abzurufen, anzulegen und zu aktualisieren.
Unsere API wird kontinuierlich weiterentwickelt und verbessert.
Jedes Update der API führt zu einer Änderung der Versionsnummer.
Über die Angabe der Versionsnummer in der Austauschdatei bleibt jede Version in sich stabil und ist von den Änderungen der neuen Version nicht betroffen.
Manchmal lassen sich allerdings Breaking Changes nicht vermeiden, bspw. wenn eine neue Funktion eine inkompatible Änderung des zugrunde liegenden Datenmodells erfordert. Darüber informieren wir allerdings im Änderungsprotokoll der API.
Datentypen der JSON-Propertys
Datentyp | Beispiel | Bemerkung |
|---|---|---|
string | Abcdefg123 | Alphanumerisch |
number | 155.13 | Nummerisch |
utcdate | 2023-02-14T00:00:00Z | Datumzeit als UTC (ISO 8601) |
bool | true/false | Wahr oder Falsch |
object | {…} | Beinhaltet weitere Propertys |
array | [{…}, {…}] | Beinhaltet mehrere Objekte |
Regeln der JSON-Propertys
Regel | Ausprägungen |
|---|---|
defarule | m = mandatory, o = optional, i = ignored |
updrule | m = mandatory, o = optional, i = ignored |
readrule | m = mandatory, o = optional, i = ignored |
API-Operationen
Aktion
Aktion | Bemerkung |
|---|---|
Anlegen | Legt die Datensätze an. Bestehende Datensätze werden nicht aktualisiert. |
Aktualisieren | Aktualisiert bestehende Datensätze. |
Lesen | Gibt den zu lesenden Datensatz zurück. |