Skip to main content
View as Markdown

Actions HTTP et webhook

La famille http effectue des appels HTTP sortants vers des API externes (éventuellement authentifiés via une connexion stockée). La famille webhook envoie des webhooks sortants signés et écrit une réponse personnalisée vers un déclencheur webhook entrant.

HTTP — Requêtes sortantes

Six operators. L'operator générique request prend un method explicite ; les operators de verbe (get/post/put/patch/delete) sont des raccourcis et acceptent une référence connection pour les appels authentifiés.

Operator Props clés Description
request url, method, headers?, body?, contentType?, timeout?, expectedStatus? Requête générique avec une méthode explicite (templatable).
get url, headers?, timeout?, expectedStatus?, connection? HTTP GET.
post url, headers?, body?, contentType?, timeout?, expectedStatus?, connection? HTTP POST.
put (identique à post) HTTP PUT.
patch (identique à post) HTTP PATCH.
delete url, headers?, body?, timeout?, expectedStatus?, connection? HTTP DELETE.
Prop partagée Description
url URL de la requête (templatable).
headers Carte des en-têtes de requête (valeurs templatables, par ex. Authorization: 'Bearer $env.API_KEY').
body Corps de chaîne ou d'objet JSON.
contentType json (par défaut) / form / text / xml.
timeout Timeout par requête en ms.
expectedStatus Tableau de codes de statut HTTP acceptables ; tout autre fait échouer l'étape.
connection Nom d'une connexion stockée — injecte les informations d'identification OAuth2/clé API/basic/bearer. 
- name: createContact
  type: http
  operator: post
  props:
    url: 'https://api.crm.example/contacts'
    connection: crm-oauth
    contentType: json
    body: { email: '{{trigger.data.email}}', name: '{{trigger.data.name}}' }
    expectedStatus: [200, 201]

Webhook — Sortant et réponse

Deux operators. send déclenche un webhook sortant signé ; response écrit la réponse HTTP pour une automatisation démarrée par un déclencheur webhook.

Operator Props Description
send url, event, data?, secret? Envoie un webhook sortant avec un nom d'event et un secret HMAC optionnel.
response status?, body?, headers? Définit la réponse HTTP renvoyée à l'appelant entrant (uniquement pour le déclencheur webhook). 
# Notify a downstream service
- name: notifyDownstream
  type: webhook
  operator: send
  props:
    url: 'https://hooks.example.com/orders'
    event: order.created
    data: { id: '{{trigger.data.id}}' }
    secret: $env.OUTGOING_WEBHOOK_SECRET

# Reply to the inbound caller
- name: ack
  type: webhook
  operator: response
  props: { status: 200, body: { ok: true } }

Pages connexes