Schreiben von FileMaker Data API-Aufrufen

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.

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.