Accedere alla sessione di un database utilizzando un account ID Claris (FileMaker Cloud)

Per i file ospitati da FileMaker Cloud, gli utenti sono autenticati tramite account ID Claris. Gli account ID Claris vengono definiti nel sistema del provider di identità ID Claris.

Per accedere a un database ospitato utilizzando un account ID Claris, utilizzare un metodo POST HTTP con endpoint API sessions specificando il nome di un database ospitato. Il token ID Claris è specificato in una stringa di intestazione Authorization. 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

Intestazione HTTP

Content-Type: application/json

Authorization: FMID {token-FMID}

token-FMID è il token ID Claris fornito dal sistema del provider di identità ID Claris. Per informazioni sul token ID Claris, vedere Utilizzo dell'ID Claris per l'autenticazione esterna nella Guida della Claris Customer Console.

Vedere Modifica dell'accesso tramite account ID Claris o di IdP esterno nella Guida di FileMaker Pro.
Parametri Un gruppo vuoto di parentesi graffe. Ad esempio: { }
Risposta

Il token di accesso, un corpo della risposta vuoto 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
Header
X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34
Copia
Body
{
  "response": {},
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Vedere Risposte di errore.

Note 

  • Per utilizzare le chiamate FileMaker Data API con FileMaker Cloud, è innanzitutto necessario eseguire l'autenticazione utilizzando l'account ID Claris e recuperare i token di sessione richiesti. I token sono validi per un'ora. Se è trascorsa più di un'ora dall'ultima autenticazione ID Claris, è possibile che le chiamate API falliscano e venga visualizzato l'errore 401. Per risolvere il problema, autenticarsi nuovamente con l'account ID Claris e recuperare i nuovi token di sessione.