Schreiben von OData API-Aufrufen

OData verwendet die folgenden HTTP-Methoden:

• POST

  Verwendet für Erstellen einer Tabelle, Erstellen eines Feldindex, Datensatz erstellen, Aktualisieren von Datensatzverweisen und Ausführen von Scripts

• GET

  Verwendet für Datenbankstruktur und Metadaten, Abfrage-Optionen und Anfordern von Daten

• PATCH

  Verwendet für Datensatz aktualisieren, Aktualisieren von Datensatzverweisen, Containerfelder in einem Datensatz mit Base64-kodierten Daten aktualisieren, Containerfeld in einem Datensatz mit Binärdaten aktualisieren und Hinzufügen von Feldern in einer Tabelle

• DELETE

  Verwendet für Tabelle löschen, Löschen eines Felds aus einer Tabelle, Datensatz löschen und Aktualisieren von Datensatzverweisen

OData verwendet die folgenden Header:

• Authorization: muss bei allen Abfragen angegeben werden. Informationen zum erforderlichen Format finden Sie unter Erstellen einer authentifizierten Verbindung zum Host.

• Accept: zeigt das Format der erwarteten Antwort an. Falls angegeben, muss es eines der folgenden Formate sein:

  • application/json (Standard)

  • application/atom+xml (oder application/xml)

  • text/html

  Für JSON-Anwendungen wird die folgende JSON-spezifische Option unterstützt: IEEE754Compatible=true. Sie zeigt an, dass Felder mit dem Typ Edm.Int64 und Edm.Decimal als Zeichenfolgenwerte zurückgegeben werden. Siehe OData 4.01 JSON Format (Englisch).

  Der Wert wird durch den Wert der Abfrage-Option $format überschrieben, falls angegeben. Siehe „Header Accept“ in OData 4.01 Protocol (Englisch).

• Content-Type: zeigt das Format des Anforderungsteils für POST- und PATCH-Methoden an. Falls angegeben, muss es eines der folgenden Formate sein:

  • application/json (Standard)

  • application/atom+xml (oder application/xml)

  • multipart/mixed (für $batch Operationen)

  • oder, für die Aktualisierung eines Containerfelds mit Binärdaten, ein in Containerfeld in einem Datensatz mit Binärdaten aktualisieren definierter Wert

  Siehe „Header Content-Type“ in OData 4.01 Protocol (Englisch).

• OData-Version: zeigt die Version des OData-Protokolls an. FileMaker Cloud und FileMaker Server unterstützen OData 4.0. Siehe „Header OData-Version“ in OData 4.01 Protocol (Englisch).

• OData-MaxVersion: zeigt die maximale Version für das OData-Protokoll an. FileMaker Cloud und FileMaker Server unterstützen OData 4.0. Siehe „Header OData-MaxVersion“ in OData 4.01 Protocol (Englisch).

• Prefer: Die folgenden Werte werden unterstützt:

  • odata.continue-on-error

  • odata.maxpagesize

  • return=representation

  • return=minimal

  Siehe „Header Prefer“ in OData 4.01 Protocol (Englisch).

https://host/fmi/odata/version/datenbankname

host – FileMaker Cloud- oder FileMaker Server-Hostname

version – die OData-Version, immer v4

datenbankname – der Name der bereitgestellten Datenbank

Beispiel: /fmi/odata/v4/ContentMgmt