Se connecter à une session de base de données avec un compte Claris ID (FileMaker Cloud)

Pour les fichiers hébergés par FileMaker Cloud, les utilisateurs sont authentifiés via des comptes Claris ID. Les comptes Claris ID sont définis dans le système de fournisseur d'identité Claris ID.

Pour vous connecter à une base de données hébergée avec un compte Claris ID, utilisez une méthode HTTP POST avec le point de terminaison API sessions en indiquant le nom d'une base de données hébergée. Le jeton Claris ID est indiqué dans une chaîne d'en-tête Authorization. Votre code reçoit un jeton d'accès qui définit la connexion à la base de données. Cette connexion est appelée session de base de données.

Méthode HTTP

POST

URL

/fmi/data/version/databases/nom-base/sessions

version : la version FileMaker Data API demandée peut utiliser v1, v2 ou vLatest

nom-base : nom de la base de données hébergée.

En-tête HTTP

Content-Type: application/json

Authorization: FMID {Jeton-FMID}

Jeton-FMID est le jeton Claris ID fourni par le système de fournisseur d'identité Claris ID. Pour obtenir des informations supplémentaires sur le jeton Claris ID, consultez la section Utilisation de Claris ID pour l'authentification externe dans l'aide Claris Customer Console.

Consultez la section Modification de l'accès des comptes Claris ID ou d'IdP externe dans l'aide de FileMaker Pro.
Paramètres Un ensemble d'accolades vides. Par exemple : { }
Réponse

Le jeton d'accès, un corps de réponse vide et un tableau de messages indiquant un code d'erreur de 0.

L'en-tête X-FM-Data-Access-Token est renvoyé dans la réponse. Il correspond au jeton de session à utiliser pour les appels d'API suivants.

Par exemple :

Copier
En-tête
X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34
Copier
Corps
{
  "response": {},
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Consultez la section Codes d'erreur.

Remarques 

  • Pour utiliser les appels FileMaker Data API avec FileMaker Cloud, vous devez d'abord vous authentifier à l'aide de votre compte Claris ID et récupérer les jetons de session requis. Les jetons sont valables pendant une heure. Si cela fait plus d'une heure depuis la dernière authentification Claris ID, il se peut que les appels API échouent avec une erreur 401. Pour résoudre le problème, authentifiez-vous à nouveau à l'aide de votre compte Claris ID et récupérez les nouveaux jetons de session.