Configurar la autenticación
Cómo autenticar tus peticiones con el header X-API-Key, incluida la configuración en Postman.
Todas las peticiones al endpoint de envío de mensajes se autentican con un header HTTP propio, no con Bearer token ni con Basic Auth:
X-API-Key: <su API key>Nota: siempre en el header, nunca en la URL. El API key debe viajar únicamente en el header
X-API-Key. Nunca lo envíes como parámetro de la URL (query param): quedaría expuesto en logs, historial del navegador y trazas intermedias.
Configuración recomendada en Postman
Si usas Postman para probar tu integración, configura la autenticación desde la pestaña Authorization en lugar de capturar el header a mano: Postman genera el header automáticamente y enmascara el valor en pantalla.
| Campo | Valor |
|---|---|
| Auth Type | API Key |
| Key | X-API-Key |
| Value | Tu API key |
| Add to | Header |
Tip: el desplegable Add to también ofrece Query Params, lo que enviaría tu clave dentro de la URL. Usa siempre Header.
Si tienes varias peticiones (por ejemplo distintos tipos de mensaje), configura la autenticación una sola vez a nivel de colección y deja cada petición en "Inherit auth from parent": al rotar la clave, la actualizas en un solo lugar.