API Reference

Endpoints públicos del API (auth por API key). Generado desde el OpenAPI del repositorio.

Base URL: https://developer-api.dulabs.co/api/v1

Auth: Authorization: Bearer dl_live_… (API key)

Spec OpenAPI: /api/developers/openapi

POST/messages

Enviar un mensaje

Encola un mensaje de WhatsApp. Requiere la cabecera `Idempotency-Key` para reintentos seguros (sin doble envío).

Parámetros

Idempotency-Key (header, requerido) — Clave única por operación (p. ej. un UUID). Reintentar con la misma clave y el mismo payload no duplica el envío.

Cuerpo (SendMessageRequest)

Campo	Tipo	Req.	Descripción
whatsappNumberId	string	sí	Id del número conectado (de GET /whatsapp-numbers).
to	string	sí	Destinatario en E.164 (solo dígitos), p. ej. 573000000000.
type	string ("text")	—	Solo `text` en V1.
text	object	sí

Respuestas

200 — Idempotente: réplica exacta de un envío ya aceptado. (SendMessageDuplicate)
201 — Mensaje encolado. (SendMessageAccepted)
400 — Error uniforme de la API. (Error)
401 — Error uniforme de la API. (Error)
403 — Error uniforme de la API. (Error)
409 — Misma Idempotency-Key con payload distinto (`idempotency_conflict`). (Error)
429 — Rate limit o cuota mensual agotada. Incluye `Retry-After` en rate limit. (Error)
500 — Error uniforme de la API. (Error)

GET/messages/{id}

Estado de un mensaje

Parámetros

id (path, requerido) — jobId devuelto al enviar.

Respuestas

200 — Estado del mensaje. (Message)
401 — Error uniforme de la API. (Error)
404 — Error uniforme de la API. (Error)

GET/whatsapp-numbers

Listar números conectados

Respuestas

200 — Números del workspace. (NumbersList)
401 — Error uniforme de la API. (Error)

GET/whatsapp-numbers/{id}

Obtener un número

Parámetros

id (path, requerido)

Respuestas

200 — Número. (Number)
401 — Error uniforme de la API. (Error)
404 — Error uniforme de la API. (Error)

GET/usage

Uso y cuota del período

Uso mensual del plan (mensajes y números). No expone precios.

Respuestas

200 — Uso del período actual. (Usage)
401 — Error uniforme de la API. (Error)

GET/me

Verificar la API key

Confirma que la API key funciona y a qué workspace pertenece. Nunca devuelve la key completa.

Respuestas

200 — Identidad de la API key. (Me)
401 — Error uniforme de la API. (Error)

GET/webhooks

Listar webhooks configurados

Respuestas

200 — Webhooks del workspace. (WebhookList)
401 — Error uniforme de la API. (Error)

POST/webhooks

Configurar el webhook de un número

Crea o reemplaza el webhook del número. Devuelve el secreto de firma UNA sola vez (guárdalo). La URL se valida contra SSRF.

Cuerpo (ConfigureWebhookRequest)

Campo	Tipo	Req.	Descripción
whatsappNumberId	string	sí
url	string	sí	HTTPS público; validado contra SSRF.

Respuestas

201 — Webhook configurado (secreto mostrado una vez). (ConfigureWebhookResponse)
400 — Error uniforme de la API. (Error)
401 — Error uniforme de la API. (Error)
404 — Error uniforme de la API. (Error)