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, PATCH y PUT. 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).

  • Preferencia:

    Se admiten los siguientes valores de protocolo OData 4.01:

    • odata.continue-on-error

    • odata.maxpagesize

    • return=representation

    • return=minimal

    Consulte "Header Prefer" en Protocolo OData 4.01.

    Se admiten los siguientes valores específicos de FileMaker:

    • fmodata.basic-timestamp: para responder con el formato de fecha y hora de FileMaker en lugar del formato de hora Zulu

    • fmodata.gmtoffset: para responder con la diferencia horaria respecto al meridiano de Greenwich

    • fmodata.entity-ids: para responder con los ID de tabla y campo

    • fmodata.include-specialcolumns: para responder con ROWID y ROWMODID

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, PATCH y PUT.