Ecrire des appels FileMaker Data API

FileMaker Data API utilise les méthodes HTTP suivantes :

• POST

  Utilisée pour Se connecter à une session de base de données, Créer un enregistrement, Dupliquer un enregistrement, Effectuer une requête de recherche et Uploader des données de conteneur.

• GET

  Utilisée pour Obtenir un seul enregistrement, Obtenir une plage d'enregistrements, Obtenir des métadonnées et Exécuter un script.

• PATCH

  Utilisée pour Modifier un enregistrement et Définir des valeurs de rubrique de type Global.

• DELETE

  Utilisée pour Se déconnecter d'une session de base de données et Supprimer un enregistrement.

Remarque  FileMaker Data API ne prend pas en charge le partage des ressources entre origines multiples (CORS) et la méthode OPTIONS.

FileMaker Data API utilise les en-têtes suivants :

• Content-Type: application/json

  Utilisée pour Se connecter à une session de base de données, Se déconnecter d'une session de base de données, Créer un enregistrement, Modifier un enregistrement, Effectuer une requête de recherche et Définir des valeurs de rubrique de type Global.

  Pour cet en-tête, « application/json » est la seule valeur autorisée. Concernant les requêtes HTTP qui utilisent cet en-tête, FileMaker Data API exige que le contenu soit codé au format JSON.

• Content-Type: multipart/form-data

  Utilisée pour Uploader des données de conteneur.

  Pour cet en-tête, « multipart/form-data » est la seule valeur autorisée.

• Authorization: session-token

  Utilisé avec la plupart des requêtes HTTP.

  La valeur pour access-token correspond à l'unique jeton de session renvoyé au moment de se connecter à une session. Elle est indispensable pour authentifier l'accès à la base de données hébergée. Consultez la section Se connecter à une session de base de données.

• Authorization: FMID {Jeton-FMID}

  Utilisé avec les requêtes HTTP pour les bases de données hébergées par FileMaker Cloud.

  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.

• X-FM-Data-OAuth-Request-Id

  Utilisé pour Se connecter à une session de base de données avec un fournisseur d'identité OAuth et Obtenir des métadonnées. Cet en-tête précise la valeur d'en-tête X-FMS-Request-ID renvoyée depuis l'URL /oauth/getoauthurl.

• X-FM-Data-OAuth-Identifier

  Utilisé pour Se connecter à une session de base de données avec un fournisseur d'identité OAuth et Obtenir des métadonnées. Cet en-tête précise l'identifiant renvoyé par le fournisseur OAuth.

Les URL FileMaker Data API commencent toutes par :

• Pour indiquer que la version une doit être utilisée : /fmi/data/v1/databases

• Pour indiquer que la dernière version doit être utilisée : /fmi/data/vLatest/databases