Solicitudes HTTP

Llama a cualquier API después de una decisión —método, URL, headers y un cuerpo JSON construido con variables y secretos del workspace— entregada con reintentos, un Idempotency-Key y una firma.

Un destino de solicitud a API (tipo http) llama a cualquier API HTTP con una solicitud que tú diseñas —crear un lead en tu CRM, abrir un ticket, publicar en Slack— en segundo plano, con reintentos. Los tokens se quedan en los secretos del workspace, nunca en la decisión.

Configúrala

{
  "key": "create_lead",
  "type": "http",
  "when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
  "params": {
    "email": { "from": "state.email", "required": true },
    "score": { "from": "composites.lead_score" }
  },
  "http": {
    "method": "POST",
    "url": "https://api.crm.example.com/v2/leads?source={{decision.slug}}",
    "headers": [{ "name": "Authorization", "value": "Bearer {{secrets.CRM_TOKEN}}" }],
    "body": "{\"email\": {{params.email}}, \"score\": {{params.score}}, \"note\": \"Routed to {{result.route}} by Dcision\"}"
  }
}
CampoTipoPredeterminadoDescripción
methodstringPOSTGET, POST, PUT, PATCH o DELETE.
urlstring—https://… o {{secrets.NAME}} con la URL completa; hasta 2,048 caracteres, variables codificadas para URL.
headersarray[]Hasta 20 pares { "name", "value" }; valores de hasta 2,048 caracteres, con variables y secretos.
bodystringlos params como JSONSolo POST, PUT y PATCH: una plantilla JSON de hasta 10,000 caracteres.

El cuerpo

El cuerpo es una plantilla JSON: fuera de comillas, una variable se convierte en un valor JSON; dentro de comillas, se convierte en texto. Consulta Cuerpos JSON. Con el destino anterior, el CRM recibe:

{ "email": "ana@acme.com", "score": 0.8414, "note": "Routed to sales by Dcision" }
  • Sin plantilla de cuerpo en POST, PUT o PATCH: los params se envían como un objeto JSON.
  • Se define Content-Type: application/json a menos que agregues tu propio header Content-Type.
  • GET y DELETE no tienen cuerpo: un cuerpo en ellos es un error de schema. Sus params se agregan a la query string (?email=ana%40acme.com&score=0.8414), salvo que la URL ya use {{params.…}}.

Headers

Tus headers se envían junto con los de Dcision:

HeaderValor
Tus headersSus valores renderizados como texto; los saltos de línea se convierten en espacios.
Content-Typeapplication/json cuando hay cuerpo, a menos que lo definas tú.
User-AgentDcision-Destinations/1.0 (+https://docs.dcision.io/destinations), a menos que lo definas tú.
Idempotency-KeyEl ID de la entrega, dlv_…, a menos que lo definas tú: el mismo en cada intento, para que las APIs que admiten claves de idempotencia nunca apliquen un reintento dos veces.
Dcision-Delivery, Dcision-Attempt, Dcision-Event, Dcision-SignatureComo en los webhooks.

Algunos nombres los define Dcision o la capa HTTP y no se pueden usar: Host, Content-Length, Connection, Transfer-Encoding, Upgrade, Keep-Alive, TE, Trailer, Expect, y cualquier nombre que empiece por Proxy- o Dcision-.

Autenticación

Pon las credenciales en un header con un secreto —Authorization: Bearer {{secrets.CRM_TOKEN}}— o en la URL como secreto cuando la API espera una URL secreta ({{secrets.SLACK_WEBHOOK}}). Las credenciales dentro de la propia URL (https://user:password@…) se rechazan.

La firma

Las solicitudes a APIs se firman como los webhooks, sobre el cuerpo exacto enviado (un cuerpo vacío para GET y DELETE). Si la API receptora es tuya, verifica Dcision-Signature con verifySignature (TypeScript) o verify_signature (Python): el cuerpo es tu plantilla, no un evento de webhook. Consulta Verifica la firma.

Ejemplo: un mensaje de Slack

Los incoming webhooks de Slack esperan su propio JSON, así que usa una solicitud a API con la URL del webhook guardada como secreto:

{
  "key": "escalation_alert",
  "type": "http",
  "when": { "actions": ["escalate"] },
  "params": { "message": { "from": "state.message" } },
  "http": {
    "method": "POST",
    "url": "{{secrets.SLACK_WEBHOOK}}",
    "body": "{\"text\": \"{{decision.slug}} asks for a person ({{action}}): {{params.message}}\"}"
  }
}

El mensaje se escribe dentro de comillas, así que el param se inserta como texto escapado: las comillas y los saltos de línea del mensaje del lead no pueden romper el JSON.

En esta página