Scrivere le chiamate FileMaker Data API

Componente	Descrizione
Un metodo HTTP (detto anche verbo HTTP)	FileMaker Data API utilizza i seguenti metodi HTTP: POST Utilizzato per Accedere alla sessione di un database, Creare un record, Duplicare un record, Eseguire una richiesta di ricerca e Caricare dati Contenitore. GET Utilizzato per Ricavare un singolo record, Ricavare una serie di record, Ricavare i metadati ed Esecuzione di uno script. PATCH Utilizzato per Modificare un record e Impostare valori di campi globali. DELETE Utilizzato per Disconnettersi dalla sessione di un database ed Eliminare un record. Nota FileMaker Data API non supporta la condivisione di risorse tra le origini (CORS) e il metodo OPZIONI.
Intestazioni HTTP	FileMaker Data API utilizza le seguenti intestazioni: Content-Type: application/json Utilizzata per Accedere alla sessione di un database, Disconnettersi dalla sessione di un database, Creare un record, Modificare un record, Eseguire una richiesta di ricerca e Impostare valori di campi globali. Per questa intestazione, "application/json" è l'unico valore consentito. Per le richieste HTTP che utilizzano questa intestazione, FileMaker Data API richiede che i contenuti siano codificati in formato JSON. Content-Type: multipart/form-data Utilizzata per Caricare dati Contenitore. Per questa intestazione, "multipart/form-data" è l'unico valore consentito. Authorization: `token-sessione` Utilizzata per la maggior parte delle richieste HTTP. Il valore `token-accesso` corrisponde al token di sessione univoco restituito quando si accede a una sessione. È necessario per autenticare l'accesso al database ospitato. Vedere Accedere alla sessione di un database. Authorization: FMID {`token-FMID`} Utilizzata per le richieste HTTP per i database ospitati da FileMaker Cloud. `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. X-FM-Data-OAuth-Request-Id Utilizzata per Accedere alla sessione di un database utilizzando un provider di identità OAuth e Ricavare i metadati. Questa intestazione specifica il valore dell'intestazione X-FMS-Request-ID restituito dall'URL /oauth/getoauthurl. X-FM-Data-OAuth-Identifier Utilizzata per Accedere alla sessione di un database utilizzando un provider di identità OAuth e Ricavare i metadati. Questa intestazione specifica l'identificativo restituito dal provider OAuth.
Un URL di chiamata	Gli URL di FileMaker Data API iniziano tutti con: Per specificare che si deve utilizzare la versione uno: `/fmi/data/v1/databases` Per specificare che si deve utilizzare l'ultima versione: `/fmi/data/vLatest/databases`
Dati dei parametri in formato JSON	Non necessari per Disconnettersi dalla sessione di un database, Ricavare i metadati, Eliminare un record, Duplicare un record, Ricavare un singolo record, Ricavare una serie di record o Esecuzione di uno script.

Un metodo HTTP (detto anche verbo HTTP)

FileMaker Data API utilizza i seguenti metodi HTTP:

POST

Utilizzato per Accedere alla sessione di un database, Creare un record, Duplicare un record, Eseguire una richiesta di ricerca e Caricare dati Contenitore.

GET

Utilizzato per Ricavare un singolo record, Ricavare una serie di record, Ricavare i metadati ed Esecuzione di uno script.

PATCH

Utilizzato per Modificare un record e Impostare valori di campi globali.

DELETE

Utilizzato per Disconnettersi dalla sessione di un database ed Eliminare un record.

Nota FileMaker Data API non supporta la condivisione di risorse tra le origini (CORS) e il metodo OPZIONI.

Intestazioni HTTP

FileMaker Data API utilizza le seguenti intestazioni:

Content-Type: application/json

Utilizzata per Accedere alla sessione di un database, Disconnettersi dalla sessione di un database, Creare un record, Modificare un record, Eseguire una richiesta di ricerca e Impostare valori di campi globali.

Per questa intestazione, "application/json" è l'unico valore consentito. Per le richieste HTTP che utilizzano questa intestazione, FileMaker Data API richiede che i contenuti siano codificati in formato JSON.

Content-Type: multipart/form-data

Utilizzata per Caricare dati Contenitore.

Per questa intestazione, "multipart/form-data" è l'unico valore consentito.

Authorization: token-sessione

Utilizzata per la maggior parte delle richieste HTTP.

Il valore token-accesso corrisponde al token di sessione univoco restituito quando si accede a una sessione. È necessario per autenticare l'accesso al database ospitato. Vedere Accedere alla sessione di un database.

Authorization: FMID {token-FMID}

Utilizzata per le richieste HTTP per i database ospitati da FileMaker Cloud.

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.

X-FM-Data-OAuth-Request-Id

Utilizzata per Accedere alla sessione di un database utilizzando un provider di identità OAuth e Ricavare i metadati. Questa intestazione specifica il valore dell'intestazione X-FMS-Request-ID restituito dall'URL /oauth/getoauthurl.

X-FM-Data-OAuth-Identifier

Utilizzata per Accedere alla sessione di un database utilizzando un provider di identità OAuth e Ricavare i metadati. Questa intestazione specifica l'identificativo restituito dal provider OAuth.

Un URL di chiamata

Gli URL di FileMaker Data API iniziano tutti con:

Per specificare che si deve utilizzare la versione uno: /fmi/data/v1/databases

Per specificare che si deve utilizzare l'ultima versione: /fmi/data/vLatest/databases

Dati dei parametri in formato JSON

Non necessari per Disconnettersi dalla sessione di un database, Ricavare i metadati, Eliminare un record, Duplicare un record, Ricavare un singolo record, Ricavare una serie di record o Esecuzione di uno script.