API de iNode

La API de iNode le permite acceder de forma programática a sus datos de tráfico, dispositivos y enlaces. Esta página cubre todo lo que necesita para comenzar: desde la autenticación de sus solicitudes hasta la ejecución de ejemplos completos de la API en varios lenguajes. Ya sea que esté integrando iNode en un sistema existente o creando un flujo de trabajo personalizado, las secciones siguientes le guiarán a través de la configuración, paso a paso.

Autenticación

iNode admite dos métodos de autenticación: OAuth2 y API Key. Elija el método que mejor se adapte a su configuración. Se recomienda OAuth2 para aplicaciones que necesitan capacidades de renovación de tokens, mientras que el método API Key es más simple e ideal para integraciones rápidas.

OAuth2

Para usar OAuth2, comuníquese con el equipo de soporte de SMATS para recibir su client_id y client_secret, que estarán vinculados a su cuenta.

Una vez que tenga esas credenciales, puede usar el nombre de usuario y la contraseña de la cuenta de propietario de su empresa, junto con el client_id y el client_secret, para obtener un token de acceso.

Construya el cuerpo de autenticación como se muestra a continuación. Tenga en cuenta que el tipo de contenido debe configurarse como application/x-www-form-urlencoded.

API Key

El método API Key es la forma más sencilla de acceder a la API de iNode. Para obtener su clave, vaya a Settings > My Profile > API Access en el panel de iNode y copie la clave que se muestra allí.

Solo los usuarios de iNode con el rol Owner pueden acceder a la clave de API desde el panel.

Una vez que tenga su clave de API, inclúyala en el encabezado Authorization de cada solicitud que envíe a la API de iNode, como se muestra en los ejemplos a continuación. Los siguientes ejemplos realizan una solicitud GET al punto final v1 de iNode para recuperar los enlaces.

Ejemplo de API

Los siguientes ejemplos de Python muestran cómo realizar llamadas de API autenticadas para recuperar sus enlaces y dispositivos. Se proporcionan dos versiones, una para cada método de autenticación. Ambos ejemplos recuperan la lista completa de enlaces y dispositivos cada minuto, en un bucle.

Autenticación OAuth2

Use este ejemplo si se autenticó mediante el método OAuth2. Incluye la lógica para renovar automáticamente su token de acceso cuando expire (después de 5 días).

Comience definiendo sus credenciales y las URL de los puntos finales:

El tipo de contenido debe ser application/x-www-form-urlencoded.

A continuación, autentíquese y almacene sus tokens. La función get_new_token se encarga de renovar el token cuando el token de acceso expira:

Con la autenticación configurada, el siguiente bucle recupera sus enlaces y dispositivos cada 60 segundos. Si el token ha expirado (respuesta 401), se renueva automáticamente antes de continuar:

Autenticación con clave de API

Si obtuvo su clave de API desde iNode > Settings > Profile > API Access (solo Owner), use el siguiente ejemplo en su lugar. Este enfoque es más simple: no se requiere gestión de tokens.

Configure las URL de sus puntos finales e incluya su clave de API en el encabezado:

Luego ejecute el bucle para recuperar sus enlaces y dispositivos cada 60 segundos:

Documentación de Swagger

La referencia completa de la API de iNode está disponible a través de la documentación de Swagger.

Debe haber iniciado sesión en iNode para acceder a la documentación de Swagger.