Accedere alla sessione di un database

Per accedere a un database ospitato, utilizzare un metodo POST HTTP con endpoint API sessions specificando il nome di un database ospitato. Nome account e password sono specificati in una stringa di intestazione Authorization. Se nome account e password vengono autenticati, il codice riceve un token di accesso che definisce la connessione al database. Questa connessione viene chiamata sessione del database.

Metodo HTTP

POST

URL

/fmi/data/versione/databases/nome-database/sessions

versione – la versione di FileMaker Data API richiesta può utilizzare la v1, v2 o vLatest

nome-database – nome del database ospitato

Intestazioni HTTP

Content-Type: application/json

Authorization: Basic account:password

  • account:password - la stringa con codifica Base64 che rappresenta il nome account, due punti (:) e la password utilizzata per accedere al database ospitato. Questo segue lo schema di autenticazione standard HTTP Basic. Ad esempio, se il nome account è admin e la password è admin, allora questo valore è il valore con codifica Base64 di admin:admin, ovvero YWRtaW46YWRtaW4=.

    In questo esempio, il valore dell'intestazione Authorization:

    Basic YWRtaW46YWRtaW4=

Parametri

Un gruppo vuoto di parentesi graffe. Ad esempio: { }

In alternativa, è possibile utilizzare il parametro fmDataSource per accedere a un'origine dati esterna. Vedere Accedere a un'origine dati esterna.

Risposta

Il token di accesso, un corpo della risposta con il token di accesso e una matrice di messaggi con un codice di errore 0.

Come risposta, viene restituita l'intestazione X-FM-Data-Access-Token, ovvero il token di sessione da utilizzare per le chiamate API successive.

Ad esempio:

Copia
Intestazione
X-FM-Data-Access-Token: c4d2e429122e9cdeda19bb23c55cd2a8f282c3cc50c60943a110
Copia
Corpo
{
  "response": {
    "token": "c4d2e429122e9cdeda19bb23c55cd2a8f282c3cc50c60943a110"
  },
  "messages": [
    {
      "message": "OK"
      "code": "0"
    }
  ]
}

Vedere Risposte di errore.