Creare un webhook

Per creare un webhook, usare il metodo POST. Il corpo POST deve contenere almeno i parametri webhook e tableName in formato JSON.

Componente Descrizione

Metodo HTTP

POST

URL

https://host/fmi/odata/versione/nome-database/Webhook.Aggiungi

host – nome host FileMaker Cloud o FileMaker Server

versione – versione OData, sempre v4

nome-database – nome del database ospitato

Esempio: /fmi/odata/v4/GestContatti/Webhook.Aggiungi
Parametri

Esempio JSON:

Copia 
{
  "webhook": "https://mio.esempio.com:8080/webhook",
  "endpointHeaders": {
    "Content-Type": "applicazione/json"
  },
  "queryHeaders": {
     "Prefer": "fmodata.entity-ids",
     "Accept": "application/json;IEEE754Compatible=true"
  },
  "tableName": "miaTabella",
  "notifySchemaChanges": true,
  "select": "ChiavePrimaria,CreatoDa",
  "filter": "CreatoDa eq 'Admin'",
  "maxFailedAttempts": 10
}

Note 

  • queryHeaders controlla come viene generato il payload del webhook, mentre endpointHeaders (o il precedente headers) viene sempre inviato all'endpoint senza influire sull'elaborazione. Nell'esempio di cui sopra, queryHeaders con:

    • "Prefer": "fmodata.entity-ids" farà sì che il payload del webhook utilizzi gli ID delle entità, anziché i nomi delle tabelle e dei campi.

    • "Accept": "application/json;IEEE754Compatible=true" racchiuderà i valori decimali tra virgolette.

  • maxFailedAttempts si applica al webhook creato. L'impostazione di maxFailedAttempts su 0 indica che non c'è un massimo e che il webhook riproverà a inviare il payload a tempo indeterminato finché il payload non verrà ricevuto correttamente o finché il webhook non verrà eliminato. I nuovi tentativi vengono registrati nel file fmodata.log.

  • Se nella richiesta sono inclusi solo webhook e tableName, i seguenti parametri utilizzeranno i loro valori predefiniti:

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