Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Usar la interfaz web de Django para realizar cambios en la API

Familiarícese con la interfaz web de Django.

La API de Juniper Mist se basa en un marco de transferencia de estado representacional (REST) de Django. Esta arquitectura permite una API navegable, lo que significa que puede interactuar con las API directamente desde un navegador web. Esta API permite una mayor facilidad de uso y flexibilidad al permitirle a usted y a otros usuarios realizar operaciones CRUD dentro de la API. En cierto sentido, la interfaz de Django actúa como un cliente RESTful. Esta función es útil para ejecutar operaciones CRUD en un único objeto API.

Para realizar un cambio en un objeto de configuración, debe haber iniciado sesión en el portal de Juniper Mist y conocer la ruta de la API URL del objeto. Consulte la documentación de la API para obtener detalles y parámetros para cambiar objetos. Encontrará las rutas de API URL para todos los objetos disponibles.

Esta tarea lo guía a través de cómo obtener información del dispositivo desde un punto de acceso (AP) y cambiar el nombre del AP directamente desde la interfaz de Django.

Para usar la interfaz web de Django para realizar cambios en la API:

  1. Inicie sesión en el portal de Juniper Mist.
  2. Abra la URL de la API para un dispositivo específico: https://<api-endpoint>/api/v1/sites/<site_id>/devices?name=<device name>. El nombre del dispositivo distingue entre mayúsculas y minúsculas.
    Nota:

    Cuando reutilice bloques de código, reemplace los valores de marcador de posición por valores reales, como el token de API, el ID de organización, el ID de sitio, el nombre de AP, etc.

    En este caso, la URL tendrá este aspecto (se omiten partes del site_id):

    https://{api-host}/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices?name=TEST-rename

    El navegador emite el siguiente comando a través de la interfaz de Django:

    Juniper Mist asigna a cada dispositivo un identificador único, que normalmente se basa en la dirección MAC (000000000-0000-0000-1000-<device_mac>). En el contexto de la API del dispositivo, se denomina id. Debe hacer referencia al AP para id que la API sepa a qué dispositivo específico cambiar el nombre.

  3. Para realizar el cambio, inserte el ID de dispositivo (id) en la llamada API y muéstrelo en el navegador.
    La nueva convocatoria se verá así:

    https://api.mist.com/api/v1/sites/c1947558-268d-4d31-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-5c5b3xxxxxxx

    El resultado es el mismo que el de la solicitud anterior; sin embargo, el contexto de la API ahora le permite realizar un cambio en el dispositivo específico en función del id nombre y no del nombre. Observe la falta de corchetes "[ ]".
  4. Introduzca el texto con formato Notación de objetos JavaScript (JSON) en el cuadro de entrada Contenido para la llamada de cambio de nombre de AP prevista. No es necesario incluir el ID de dispositivo único (id) porque el id contexto existe en la dirección URL.
  5. Una vez completado, presione PUT para enviar la solicitud a Juniper Mist. Los resultados deberían verse así, lo que indica que se ha cambiado el nombre del AP:

    Para obtener más información, consulte la sección Sitio del sitio de documentación de API.

Documentación relacionada