Anmeldung bei einer externen Datenquelle

Wenn sich Ihre bereitgestellte Datenbank bei einer externen Datenquelle anmelden muss, wird der Name der bereitgestellten Datenbank in der URL angegeben. Kontoname und Passwort für die bereitgestellte Datenbank werden in der Header-Zeichenfolge „Authorization“ angegeben. Datenbankname, Kontoname und Passwort für die externe Datenquelle werden im Parameter fmDataSource als ein JSON-Array angegeben.

HTTP-Methode

POST

URL

/fmi/data/version/databases/datenbankname/sessions

version – die angeforderte FileMaker Data API-Version, kann v1,v2 oder vLatest sein

datenbankname – der Name der bereitgestellten Datenbank

HTTP-Header

Content-Type: application/json

Authorization: eine Base64-kodierte Zeichenfolge, die den Kontonamen und das Passwort für die Anmeldung bei der bereitgestellten Datenbank angibt. Diese Base64-kodierte Zeichenfolge muss sich nach dem Schema der HTTP-Standardauthentifizierung richten.

Parameter

Der Parameter fmDataSource mit einem JSON-Array zur Angabe von Datenbankname, Kontoname und Passwort für die Anmeldung bei der externen Datenquelle.

Beispiel:

Kopieren 
{ 
  "fmDataSource": [
    {
      "database": "Kontakte",
      "username": "admin",
      "password": "admin" 
    }
  ]
}

Um ein OAuth-Konto für die Anmeldung bei der externen Datenquelle zu verwenden, geben Sie den Wert des Headers X-FMS-Request-ID (oAuthRequestId) und den URL-Abfragewert (oAuthIdentifier) ein.

Kopieren 
{ 
  "fmDataSource": [
    {
      "database": "Kontakte",
      "oAuthRequestId": "E65B98BB17429CO643B31119F",
      "oAuthIdentifier": "B164A3459A776E5177445DR223"
    }
  ]
}
Antwort

Der Zugriffstoken, ein leerer Antworthauptteil und ein Meldungsarray mit dem Fehlercode 0.

Der Header X-FM-Data-Access-Token wird als Antwort zurückgegeben. Dabei handelt es sich um den Sitzungstoken, der für anschließende API-Aufrufe zu verwenden ist.

Beispiel:

Kopieren 
X-FM-Data-Access-Token: c13c0f486780f2187bde6f3859dabd4dcf8ea43be420dfeadf34
{
  "response": {},
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Siehe Fehlerantworten.

Hinweise 

  • FileMaker-Datenbanken sind die einzigen unterstützten externen Datenquellen. Geben Sie den Datenbanknamen ohne die Dateinamenerweiterung .fmp12 an.

  • Dateien, die im Parameter fmDataSource angegeben sind, werden nach Bedarf geöffnet, zum Beispiel, wenn ein Script ausgeführt wird oder wenn sich der Kontext zu einem Layout ändert, das eine externe Datenquelle erfordert. Daraus resultieren Fehler bei der Anmeldung bei der externen Datenquelle, wenn versucht wird, die Dateien zu öffnen, nicht bei der Anmeldung bei der Datenbanksitzung.