Token

Cada solicitud enviada a Netux | Cloud requiere un token. Un token es una clave única que autoriza las peticiones enviadas a Netux | Cloud.

Los tokens son válidos durante 6 horas y pueden generarse utilizando la API key de tu cuenta. El API token se encuentra en la sección Mi perfil en api.netux.com. Más información sobre cómo obtener tu token.

Hay dos maneras de enviar un token en una solicitud:

1. Enviando el token en la cabecera (recomendado):

   X-Auth-Token=token
   

2. Enviando el token como parámetro de ruta:

   ?token=token
   

Aunque enviar el token como parámetro en la URL puede ser más sencillo, sólo aconsejamos hacerlo en las fases de prototipo, ya que el token es visible y, por tanto, mucho menos seguro. Para las fases de producción, recomendamos encarecidamente enviar el token en la cabecera X-Auth-Token.

🚧

Autenticación sin cabecera - ¡No se recomienda!

Aunque es posible enviar el token de autenticación como un parámetro en la URL, no incluir la cabecera X-Auth-Token, es mucho menos seguro. Incluir un token -o cualquier credencial de seguridad- en una URL hará que sea fácilmente legible en los registros de los routers, el historial de los navegadores y los rastreadores de paquetes.

// Petición de ejemplo para crear un dispositivo - Token en la cabecera

curl -X POST 'https://api.netux.com/api/v2.0/devices/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{}'
 
// Petición de ejemplo para obtener todos los dispositivos - Token como parámetro de la URL

 curl -X GET 'https://api.netux.com/api/v2.0/devices/?token=asdf657asdf675asdf876asdf' \