Iniciar una sesión en una base de datos mediante una cuenta del ID de Claris (FileMaker Cloud)

En los archivos alojados por FileMaker Cloud, los usuarios se autentican mediante las cuentas del ID de Claris. Las cuentas del ID de Claris se definen en el sistema del proveedor de identidad del ID de Claris.

Para iniciar sesión en una base de datos alojada mediante una cuenta del ID de Claris, utilice un método HTTP POST con el punto de conexión de API sessions y especifique el nombre de una base de datos alojada. El token del ID de Claris se especifica en la cadena de autorización del encabezado. El código recibe un token de acceso que define la conexión a la base de datos. Esta conexión recibe el nombre de sesión de la base de datos.

Método HTTP

POST

URL

/fmi/data/versión/databases/nombre-base-de-datos/sessions

versión: la versión de FileMaker Data API solicitada puede utilizar v1, v2 o vLatest.

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

Encabezado HTTP

Content-Type: application/json

Authorization: FMID {FMID-token}

FMID-token es el token del ID de Claris proporcionado por el 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.

Consulte Editar el ID de Claris o acceder a la cuenta del IdP externo en la Ayuda de FileMaker Pro.

Parámetros Un conjunto vacío de llaves. Por ejemplo: { }
Respuesta

El token de acceso, un cuerpo de respuesta vacío y una matriz de mensajes que muestra el código de error 0.

El encabezado X-FM-Data-Access-Token se devuelve en la respuesta, que es el token de sesión que se utilizará para las siguientes llamadas a la API.

Por ejemplo:

Copiar
Header
X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34
Copiar
Body
{
  "response": {},
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Consulte Respuestas de error.

Notas 

  • Para utilizar las llamadas de FileMaker Data API con FileMaker Cloud, debe autenticarse primero con su cuenta del ID de Claris y recuperar los tokens de sesión necesarios. Los tokens son válidos durante una hora. Si ha pasado más de una hora desde la última autenticación con el ID de Claris, las llamadas de la API pueden fallar con un error 401. Para resolver el problema, vuelva a autenticarse con la cuenta del ID de Claris y recupere nuevos tokens de sesión.