Scrivere le chiamate OData API

Le chiamate OData sono costituite dai seguenti componenti.

Componente Descrizione

Metodo HTTP

OData utilizza i seguenti metodi HTTP:

Intestazioni HTTP

OData utilizza le seguenti intestazioni:

  • Authorization: deve essere fornita con tutte le richieste. Per il formato richiesto, vedere Creare una connessione autenticata all'host .

  • Accept: indica il formato della risposta prevista. Se specificata, deve corrispondere a uno dei seguenti valori:

    • application/json (predefinito)

    • application/atom+xml (o application/xml)

    • text/html

    Per le applicazioni JSON, la seguente opzione specifica per JSON IEEE754Compatible=true è supportata e indica che come valori di stringa vengono restituiti i campi di tipo Edm.Int64 e Edm.Decimal. Vedere Formato JSON OData 4.01 (in Inglese).

    Il valore è sostituito dal valore dell'opzione di interrogazione $format, se specificato. Vedere "Header Accept" in Protocollo OData 4.01 (in Inglese).

  • Content-Type: indica il formato del corpo della richiesta per i metodi POST e PATCH. Se specificata, deve corrispondere a uno dei seguenti valori:

    Vedere "Header Content-Type" in Protocollo OData 4.01 (in Inglese).

  • OData-Version: indica la versione del protocollo OData. FileMaker Cloud e FileMaker Server supportano OData 4.0. Vedere "Header OData-Version" in Protocollo OData 4.01 (in Inglese).

  • OData-MaxVersion: indica la versione massima per il protocollo OData. FileMaker Cloud e FileMaker Server supportano OData 4.0. Vedere "Header OData-MaxVersion" in Protocollo OData 4.01 (in Inglese).

  • Prefer: sono supportati i seguenti valori:

    • odata.continue-on-error

    • odata.maxpagesize

    • return=representation

    • return=minimal

    Vedere "Header Prefer" in Protocollo OData 4.01 (in Inglese).

URL

https://host/fmi/odata/versione/nome-database

host – nome host FileMaker Cloud o FileMaker Server

versione – versione OData, sempre v4

nome-database – nome del database ospitato

Esempio: /fmi/odata/v4/GestContenuti

Esempio di dati dei parametri in JSON e Atom Solo per i metodi POST e PATCH.