Autorización: bearer-token
Todas las operaciones de la API NN Agent, excepto la verificación del estado, requieren un bearer-token en el encabezado Authorization.
curl https://api.nexifyneo.com/v2/client \
-H "Authorization: Bearer YOUR_API_TOKEN"Dónde obtener el token#
El token se emite al cliente y se proporciona al conectarse a la API a través del bot oficial @NN_official_bot. No hay un formulario separado en el sitio: el bot es la única puerta tanto al gabinete como al acceso a la API.
El token está vinculado a la cuenta, por lo que en la versión v2 el identificador del cliente no se transmite en la ruta: el servicio identifica al cliente por el token.
¿Qué regresará sin token#
La solicitud sin encabezado es rechazada con el código 401:
{
"error": { "code": "unauthorized", "message": "Missing bearer token" },
"request_id": "f04e847d-8505-4b7b-a5c8-7aee42a8fc55"
}Un token caducado o incorrecto es rechazado con el mismo código 401 pero con un mensaje diferente:
{
"error": { "code": "unauthorized", "message": "Invalid or expired token" },
"request_id": "3c254bf0-21bf-44ff-9469-56b8a34d4239"
}El análisis del campo request_id y otros códigos se encuentra en la página Errores.
Verifique el acceso con una solicitud#
curl https://api.nexifyneo.com/v2/client \
-H "Authorization: Bearer YOUR_API_TOKEN"La respuesta 200 significa que el token ha sido aceptado y está vinculado a su cuenta. La respuesta 401 indica que el token no se ha enviado o es inválido.
Advertencia de certificado#
El host api.nexifyneo.com entrega un certificado TLS autofirmado, por lo que los clientes con verificación estricta interrumpen la conexión antes de que llegue el turno del token. Si la solicitud falla en la verificación del certificado y no en 401, no se trata de autorización — ver Limitaciones conocidas.