Schreiben von FileMaker Data API-Aufrufen

Die FileMaker Data API-Aufrufe bestehen aus den folgenden Komponenten.

Komponente	Beschreibung
Eine HTTP-Methode (auch als HTTP-Verb bezeichnet)	Das FileMaker Data API verwendet die folgenden HTTP-Methoden: POST Verwendet mit Anmelden bei einer Datenbanksitzung, Erstellen eines Datensatzes, Datensatz duplizieren, Suchen und Hochladen von Containerdaten. GET Verwendet mit Abrufen eines einzelnen Datensatzes, Abrufen eines Datensatzbereichs, Metadaten abrufen und Ausführen eines Scripts. PATCH Verwendet mit Bearbeiten eines Datensatzes und Setzen von Variablenfeldwerten. DELETE Verwendet mit Abmeldung aus einer Datenbanksitzung und Datensatz löschen. Hinweis Cross-Origin Resource Sharing (CORS) und die OPTIONS-Methode werden von FileMaker Data API nicht unterstützt.
HTTP-Header	Das FileMaker Data API verwendet die folgenden Header: Content-Type: application/json Verwendet mit Anmelden bei einer Datenbanksitzung, Abmeldung aus einer Datenbanksitzung, Erstellen eines Datensatzes, Bearbeiten eines Datensatzes, Suchen und Setzen von Variablenfeldwerten. Für diesen Header ist nur der Wert „application/json“ zulässig. Für HTTP-Abfragen, die diesen Header verwenden, verlangt das FileMaker Data API, dass der Inhalt JSON-verschlüsselt ist. Content-Type: multipart/form-data Verwendet mit Hochladen von Containerdaten. Für diesen Header ist nur der Wert „multipart/form-data“ zulässig. Authorization: `session-token` Mit den meisten HTTP-Abfragen verwendet. Der Wert für `access-token` ist der eindeutige Sitzungstoken, der bei der Anmeldung bei einer Sitzung zurückgegeben wird. Er ist erforderlich, um den Zugriff auf die bereitgestellte Datenbank zu authentifizieren. Siehe Anmelden bei einer Datenbanksitzung. Authorization: FMID {`FMID-token`} Verwendet mit HTTP-Abfragen für Datenbanken, die von FileMaker Cloud bereitgestellt sind. `FMID-token` ist der Claris-ID Token, den das Claris-ID Identitätsdienstleistersystem bereitstellt. Informationen zum Claris-ID Token finden Sie unter Verwenden der Claris-ID für die externe Authentifizierung in der Claris Customer Console Hilfe. X-FM-Data-OAuth-Request-Id Verwendet mit Anmelden bei einer Datenbanksitzung mithilfe eines OAuth-Identitätsdienstleisters und Metadaten abrufen. Dieser Header gibt den X-FMS-Request-ID-Header-Wert an, der von der /oauth/getoauthurl-URL zurückgegeben wurde. X-FM-Data-OAuth-Identifier Verwendet mit Anmelden bei einer Datenbanksitzung mithilfe eines OAuth-Identitätsdienstleisters und Metadaten abrufen. Dieser Header gibt den Identifier an, der vom OAuth-Dienstleister zurückgegeben wurde.
Eine Aufruf-URL	Die FileMaker Data API-URLs beginnen alle mit einer der folgenden Angaben: Für die Angabe, dass Version 1 verwendet werden soll: `/fmi/data/v1/databases` Für die Angabe, dass die neueste Version verwendet werden soll: `/fmi/data/vLatest/databases`
Parameterdaten in JSON-Format	Nicht erforderlich für Abmeldung aus einer Datenbanksitzung, Metadaten abrufen, Datensatz löschen, Datensatz duplizieren, Abrufen eines einzelnen Datensatzes, Abrufen eines Datensatzbereichs oder Ausführen eines Scripts.

Über die Beispiele

Die Ausführung von FileMaker Data API-Operationen kann je nach verwendetem Tool manchmal schwierig sein. Die Beispiele für einige der API-Aufrufe verwenden das Befehlszeilenprogramm cURL, das in macOS und einigen Linux-Versionen verfügbar ist. Das Format und die Details Ihrer Antworten können je nach Ihrer Datenbank und der Version von cURL von den Beispielantworten abweichen.