Escribir llamadas de FileMaker Data API

Las llamadas de FileMaker Data API constan de los siguientes componentes.

Componente	Descripción
Un método HTTP (denominado también verbo HTTP)	FileMaker Data API utiliza los siguientes métodos HTTP: POST Se utiliza con Iniciar una sesión en una base de datos, Crear un registro, Duplicar un registro, Realizar una petición de búsqueda y Subir datos del contenedor. GET Se utiliza con Obtener un único registro, Obtener un intervalo de registros, Obtener metadatos y Ejecutar un guion. PATCH Se utiliza con Editar un registro y Establecer valores de campos globales. DELETE Se utiliza con Cerrar la sesión de una base de datos y Eliminar un registro. Nota FileMaker Data API no admite Cross-Origin Resource Sharing (CORS) y el método OPTIONS.
Encabezados HTTP	FileMaker Data API utiliza los siguientes encabezados: Content-Type: application/json Se utiliza con Iniciar una sesión en una base de datos, Cerrar la sesión de una base de datos, Crear un registro, Editar un registro, Realizar una petición de búsqueda y Establecer valores de campos globales. En este encabezado, solo se permite el valor "application/json". En las solicitudes HTTP que utilizan este encabezado, FileMaker Data API requiere que el contenido se codifique en formato JSON. Content-Type: multipart/form-data Se utiliza con Subir datos del contenedor. En este encabezado, solo se permite el valor "multipart/form-data". Authorization: `token-sesión` Se utiliza con la mayoría de las peticiones HTTP. El valor de `token-acceso` es el token de sesión exclusivo que se devuelve al iniciar una sesión. Es necesario para autenticar el acceso a la base de datos alojada. Consulte Iniciar una sesión en una base de datos. Authorization: FMID {`FMID-token`} Se utiliza con las peticiones HTTP para las bases de datos alojadas por FileMaker Cloud. `FMID-token` es el token del ID de Claris proporcionado por el sistema proveedor de identidad del ID de Claris. Para obtener información sobre el token del ID de Claris, consulte Usar el ID de Claris para la autenticación externa en la Ayuda de la Claris Customer Console. X-FM-Data-OAuth-Request-Id Se utiliza con Iniciar una sesión en una base de datos mediante un proveedor de identidad de OAuth y Obtener metadatos. Este encabezado especifica el valor del encabezado X-FMS-Request-ID que se devuelve desde la URL /oauth/getoauthurl. X-FM-Data-OAuth-Identifier Se utiliza con Iniciar una sesión en una base de datos mediante un proveedor de identidad de OAuth y Obtener metadatos. Este encabezado especifica el identificador que devuelve el proveedor de OAuth.
Una URL de llamada	Las URL de FileMaker Data API empiezan todas con uno de los siguientes elementos: Para especificar que se debe utilizar la versión uno: `/fmi/data/v1/databases` Para especificar que se debe utilizar la versión más reciente: `/fmi/data/vLatest/databases`
Datos de parámetros en formato JSON	No es necesario con Cerrar la sesión de una base de datos, Obtener metadatos, Eliminar un registro, Duplicar un registro, Obtener un único registro, Obtener un intervalo de registros o Ejecutar un guion.

Acerca de los ejemplos

Realizar operaciones con FileMaker Data API a veces puede resultar complicado en función de la herramienta que utilice. Los ejemplos proporcionados para algunas de las llamadas a la API utilizan la herramienta de línea de comandos cURL disponible en macOS y algunas versiones de Linux. El formato y los detalles de sus respuestas pueden ser diferentes a las respuestas de ejemplo en función de la base de datos y la versión de cURL.