Autenticación

Cada petición lleva tu clave de API en el encabezado Authorization. Una clave live envía mensajes reales; una clave test usa el entorno de pruebas.

La clave en cada petición

Authorization: Bearer test_akey_01J9XQ4M7K2VBN3PWD5Q8R7T6C_4F9…

La API solo acepta el esquema Bearer. Cualquier otra forma responde 401 con el código 10001.

❗
Importante
La clave va solo en tu backend. Nunca la incluyas en el código de un navegador ni de una app móvil: quien la tenga puede enviar códigos a tu nombre.

Formato de la clave

Una clave se lee entorno_akey_identificador_secreto: tres partes, y el identificador lleva su propio prefijo akey_.

Parte	Ejemplo	Qué es
Entorno	`live` o `test`	Producción o pruebas.
Identificador	`akey_01J9XQ4M7K2VBN3PWD5Q8R7T6C`	Identifica la clave. Aparece en registros y soporte.
Secreto	52 caracteres en mayúsculas	Distingue mayúsculas de minúsculas. Nunca se muestra dos veces.

Pruebas y producción

Las claves test_ y live_ usan la misma API, pero viven en dos entornos separados.

Una clave live_ envía mensajes reales y sus verificaciones aprobadas se facturan.
Una clave test_ no envía nada: solo acepta los destinatarios fijos del entorno de pruebas, el código es siempre el mismo y nada se factura.
Una verificación creada en un entorno no existe para el otro: comprobarla con una clave del otro entorno responde 404 con 30001.

Obtener y revocar claves

Hoy las claves las emite el equipo de Inalambria. El secreto se entrega una sola vez; guárdalo en tu gestor de secretos.

Cuando una clave se revoca, las peticiones responden 401 con 10002. Puede seguir aceptándose durante unos segundos (siempre menos de un minuto) mientras expira su caché.

Errores de autenticación

Código	HTTP	Cuándo
`10001`	401	La clave falta, está mal formada o no existe.
`10002`	401	La clave fue revocada.
`10003`	403	La clave está restringida a ciertas direcciones IP y la petición llegó desde otra.
`10010`	403	Al crear una verificación: la aplicación no tiene Verify habilitado.
`40003`	429	Demasiados fallos de autenticación desde tu IP.

📘
Nota
Los fallos de autenticación repetidos desde una misma IP activan un bloqueo temporal: por defecto, 20 fallos en 60 segundos. Mientras dura, toda petición desde esa IP responde 429 con un Retry-After que dice cuántos segundos esperar.