Crear un webhook

Para crear un webhook, utilice el método POST. El cuerpo POST debe contener al menos los parámetros webhook y tableName en formato JSON.

Componente Descripción

Método HTTP

POST

URL

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

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/GestionDeContacto/Webhook.Add
Parámetros

Ejemplo de JSON:

Copiar 
{
  "webhook": "https://my.exmple.com:8080/webhook",
  "endpointHeaders": {
    "Content-Type": "application/json"
  },
  "queryHeaders": {
     "Prefer": "fmodata.entity-ids",
     "Accept": "application/json;IEEE754Compatible=true"
  },
  "tableName": "myTable",
  "notifySchemaChanges": true,
  "select": "PrimaryKey,CreatedBy",
  "filter": "CreatedBy eq 'Admin'",
  "maxFailedAttempts": 10
}

Notas 

  • queryHeaders controla cómo se genera la carga útil de webhook, mientras que endpointHeaders (o headers) siempre se envían al punto de conexión sin afectar al procesamiento. En el ejemplo anterior, queryHeaders con:

    • "Prefer": "fmodata.entity-ids" hará que la carga útil del webhook utilice ID de entidad en lugar de nombres de tablas y campos.

    • "Accept": "application/json;IEEE754Compatible=true" encerrará los valores decimales entre comillas.

  • maxFailedAttempts se aplica al webhook creado. Establecer maxFailedAttempts en 0 indica que no hay máximo y que el webhook volverá a intentar enviar la carga útil indefinidamente hasta que la carga útil se reciba correctamente o se elimine el webhook. Los intentos de reintento se registran en el archivo fmodata.log.

  • Si en la solicitud solo se incluyen "webhook" y "tableName", los siguientes parámetros utilizarán sus valores predeterminados:

    Copiar 
    {
      ...
      "headers": {},
      "notifySchemaChanges": false,
      "maxFailedAttempts": 0,
      "select": "",
      "filter": ""
     }