Skip to main content
POST
Enviar un aviso de prueba

Authorizations

Authorization
string
header
required

Clave del negocio. sk es una clave completa (todo lo que el rol de quien la creó puede dar) y rk una restringida a los permisos que se eligieron al crearla. Solo se usa desde un servidor: un pedido desde un navegador se rechaza con browser_not_allowed.

Headers

Craqui-Version
string

Versión de la API para este pedido (YYYY-MM-DD). Si no la mandas, se usa la versión fijada en la clave cuando se creó.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-12-01"

Idempotency-Key
string
required

Obligatorio en todo POST que crea o modifica algo. Un valor único por operación (por ejemplo un UUID). Si repites el pedido con la misma clave y el mismo cuerpo dentro de 24 horas, recibes la misma respuesta sin que se repita el efecto.

Required string length: 1 - 255

Path Parameters

id
string
required

El id de la URL (whe_…). Id de una URL de avisos.

Pattern: ^whe_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"whe_2d3gn7x2sz9rgsmv8z1hdqx6h1"

Response

OK.

delivered
boolean
required

true si tu sistema respondió 2xx.

response_status
integer | null
required

El código HTTP que respondió tu sistema, si respondió.

duration_ms
integer
required
Required range: x >= 0
error_code
enum<string> | null
required

Por qué no se entregó: http_status (respondió un código que no es 2xx), redirect_not_followed (respondió una redirección: no se siguen), timeout (no respondió en 10 segundos), connection, tls (el certificado no es válido para ese nombre), blocked_destination (la URL no es pública) o invalid_response. La lista puede crecer.

Available options:
http_status,
redirect_not_followed,
timeout,
connection,
tls,
blocked_destination,
invalid_response,
null