Escribir llamadas de OData API

Las llamadas de OData incluyen los siguientes componentes.

Componente Descripción

Método HTTP

OData utiliza los siguientes métodos HTTP:

Encabezados HTTP

OData utiliza los siguientes encabezados:

  • Authorization: debe proporcionarse con todas las peticiones. Para conocer el formato necesario, consulte Crear una conexión autenticada en el anfitrión.

  • Accept: indica el formato de la respuesta esperada. Si se especifica, debe ser uno de los siguientes:

    • application/json (valor predeterminado)

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

    • text/html

    En las aplicaciones JSON, se admite la siguiente opción específica de JSON: IEEE754Compatible=true, que indica que los campos con el tipo Edm.Int64 y Edm.Decimal se devuelven como valores de cadena. Consulte Formato JSON de OData 4.01 (en ingles).

    Si se especifica, este valor se reemplaza por el valor de la opción de consulta $format. Consulte "Header Accept" en Protocolo OData 4.01 (en ingles).

  • Content-Type: indica el formato del cuerpo de la solicitud para los métodos POST y PATCH. Si se especifica, debe ser uno de los siguientes:

    Consulte "Header Content-Type" en Protocolo OData 4.01 (en ingles).

  • OData-Version: indica la versión del protocolo OData. FileMaker Cloud y FileMaker Server admiten OData 4.0. Consulte la información sobre el encabezado "Header OData-Version" en Protocolo OData 4.01 (en ingles).

  • OData-MaxVersion: indica la versión máxima del protocolo OData. FileMaker Cloud y FileMaker Server admiten OData 4.0. Consulte la información sobre el encabezado "Header OData-MaxVersion" en Protocolo OData 4.01 (en ingles).

  • Prefer: se admiten los siguientes valores:

    • odata.continue-on-error

    • odata.maxpagesize

    • return=representation

    • return=minimal

    Consulte "Header Prefer" en Protocolo OData 4.01.

URL

https://anfitrión/fmi/odata/versión/nombre-base-de-datos

anfitrión: el nombre del anfitrión de FileMaker Cloud o FileMaker Server.

versión: la versión de OData, que siempre es v4.

nombre-base-de-datos: el nombre de la base de datos alojada.

Ejemplo: /fmi/odata/v4/GestionDeContenido

Ejemplo de datos de parámetros en JSON y Atom Solo para los métodos POST y PATCH.