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\"}"
}
}| Campo | Tipo | Predeterminado | Descripción |
|---|---|---|---|
method | string | POST | GET, POST, PUT, PATCH o DELETE. |
url | string | — | https://… o {{secrets.NAME}} con la URL completa; hasta 2,048 caracteres, variables codificadas para URL. |
headers | array | [] | Hasta 20 pares { "name", "value" }; valores de hasta 2,048 caracteres, con variables y secretos. |
body | string | los params como JSON | Solo 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,PUToPATCH: los params se envían como un objeto JSON. - Se define
Content-Type: application/jsona menos que agregues tu propio headerContent-Type. GETyDELETEno 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:
| Header | Valor |
|---|---|
| Tus headers | Sus valores renderizados como texto; los saltos de línea se convierten en espacios. |
Content-Type | application/json cuando hay cuerpo, a menos que lo definas tú. |
User-Agent | Dcision-Destinations/1.0 (+https://docs.dcision.io/destinations), a menos que lo definas tú. |
Idempotency-Key | El 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-Signature | Como 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.
Webhooks
Recibe el evento firmado decision.completed en tu URL — el envoltorio, sus headers, verificar Dcision-Signature con y sin los SDKs, bodies sin procesar en Express y Next.js, rotación y deduplicación.
Funciones
Deja que tu propio código actúe sobre un resultado — la respuesta nombra la función y sus params, y los SDKs de TypeScript y Python llaman al handler que registraste, en orden y una vez por llamada.