Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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.

Inhalt

Datentypen der JSON-Propertys

Datentyp

Beispiel

Bemerkung

string

Abcdefg123

AlphanumerischAlphanummerisch

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

Bemerkung

defarule

m = mandatory, o = optional, i = ignored

Gilt für alle Aktionen (Anlegen, Aktualisieren, Lesen), wenn nicht genauer angegeben.

updrule

m = mandatory, o = optional, i = ignored

Übersteuert die defarule in der angegebenen Aktion “Aktualisieren”.

readrule

m = mandatory, o = optional, i = ignored

Übersteuert die defarule in der angegebenen Aktion “Lesen”.

API-Typen

Typ

GoliathAPIStandard

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.

Aufgabe

Aufgabe

Ausgeschlossene Aktionen

Bemerkung

Vorabcheck

Lesen

Die API simuliert die Verarbeitung und gibt eine qualifizierte Rückmeldung.

Verarbeiten

Die API legt führt die angegebenen Aktion aus.