A través de una estrecha colaboración con nuestros socios, respaldamos la necesidad crítica de expansión empresarial a través de redes de subdistribuidores o revendedores. Un desafío clave radica en ayudar a sus clientes a gestionar entornos operativos con cientos de objetos. Para abordar esto, ofrecemos diferentes herramientas que adaptan el acceso a necesidades específicas. Además del completo Panel de Administración para la gestión de clientes, dispositivos y facturación, estamos desarrollando funcionalidades impulsadas por API para automatizar tareas rutinarias y optimizar los flujos de trabajo de nuestros socios.
Una de las tareas más utilizadas es la clonación de objetos. Clonar un rastreador es útil cuando se desea proporcionar acceso a varios usuarios al mismo rastreador GPS, manteniendo cuentas de usuario separadas. Por ejemplo, suponga que ha registrado todos sus rastreadores en una cuenta de usuario, pero necesita que sus colegas monitoreen y supervisen grupos específicos de rastreadores. En ese caso, puede crear cuentas de usuario separadas para ellos en el Panel de Administración y clonar los rastreadores necesarios en sus cuentas. Para obtener más información sobre los clones, consulte el artículo “Tracker Clones”.
Un clon es una instancia virtual de un rastreador GPS existente en la plataforma Navixy. Los clones le permiten crear una o más copias de un rastreador existente y colocarlas en múltiples cuentas de usuario independientes. Esto significa que varios usuarios pueden monitorear el mismo rastreador GPS desde sus propias cuentas
Desafíos de la clonación de rastreadores entre paneles
Clonar un rastreador individual suele ser una tarea sencilla. Sin embargo, surgen desafíos al intentar replicar un rastreador entre paneles de administración dentro de la misma estructura "cuenta principal <-> revendedor". En el pasado, aunque el panel de administración principal podía acceder a todos los datos de sus revendedores, no era posible replicar rastreadores entre paneles de administración en la misma estructura... ¡Pero ese ya no es el caso!
Hemos actualizado la funcionalidad de clonación para permitir ahora la duplicación de rastreadores de un panel de administración a otro dentro de la misma estructura, todo mediante el uso de la sesión de la cuenta del panel de administración principal. Esta mejora está disponible a través de nuestra API. Además, nos complace presentar el concepto de clonación por lotes, que admite la duplicación de hasta 1,000 rastreadores en una sola operación. Más adelante en este artículo, explicaremos cómo llevar a cabo tanto los procesos de clonación individual como los de clonación por lotes.
Clonación de rastreadores dentro de la jerarquía
Esta mejora resuelve por completo el problema de la clonación de rastreadores dentro de la cuenta principal y la jerarquía de revendedores para los usuarios del API. Aunque las actualizaciones de la interfaz de usuario aún están pendientes, la funcionalidad completa ya está accesible a través del API.
Esta nueva técnica de verificación implementada en el backend permite al panel de administración principal supervisar la clonación en toda su jerarquía. Los socios ahora pueden gestionar tareas de clonación extensivas sin contactar al soporte, reduciendo la carga de trabajo para ambas partes.
A continuación se muestra un ejemplo de una posible jerarquía para la estructura Panel de Administración - Revendedor - Usuario - Rastreador:
Acceso a el API para la clonación entre paneles
En la práctica, los usuarios del API pueden aprovechar esta funcionalidad para automatizar todo el proceso de clonación dentro de su flujo de trabajo de incorporación de clientes finales. Alternativamente, el API permite la ejecución eficiente de solicitudes de clonación bajo demanda, cuando sea necesario.
A modo de ejemplo, considere el uso de un cliente HTTP como Postman para ejecutar operaciones de clonación individuales o por lotes. Postman proporciona una interfaz fácil de usar para construir y enviar solicitudes HTTP GET y POST. Aunque Postman es un ejemplo popular, cualquier cliente HTTP con funcionalidad URL será suficiente. En una sección dedicada, profundizaremos en el uso de Postman con Navixy, incluyendo la colección de Postman de Navixy. Para más información, consulte el blog “Optimice el desarrollo con Navixy API y Postman”.
Comencemos con la acción de clonación simple utilizando el método API “clon”:
1. Si aún no lo ha hecho, cree una nueva colección en Postman haciendo clic en “Create new collection” como se muestra a continuación.
2. Después de crear la nueva colección, puede comenzar a trabajar agregando una solicitud. Presione el enlace “Add Request” como se indica en la captura de pantalla a continuación.
3. Obtenemos una clave de sesión (la clave hash) utilizando las credenciales del panel de administración. El método “auth” proporciona un hash cuando se autoriza correctamente.
Configure el método POST e ingrese la URL del API:
- Si su cuenta está basada en la UE: https://api.navixy.com/v2/panel/account/auth
- Para cuentas basadas en E.E. U.U.: https://api.us.navixy.com/v2/panel/account/auth
- O puede utilizar el dominio de su interfaz de usuario: https://your-tracking-domain.com/api-v2/panel/account/auth
- En la pestaña “Headers”, agregue un nuevo encabezado “Content-type” y su valor “application/json”.
Proceda a la pestaña “Body” e ingrese las credenciales en formato JSON:
Y oprima el botón “Send” en el lado derecho.
4. Recibirá la clave hash que necesitará para realizar la acción de clonación. Cualquier acción en el panel requiere una clave hash. Simplemente pasamos por todos los pasos aquí, para que todo quede claro después de leer el artículo.
5. Después de obtener la clave hash, puede proceder con la clonación. Cambie la URL a la siguiente:
- Si su cuenta está basada en la UE: https://api.navixy.com/v2/panel/tracker/clone
- Para cuentas basadas en E.E. U.U.: https://api.us.navixy.com/v2/panel/tracker/clone
- O puede utilizar el dominio de su interfaz de usuario: https://your-tracking-domain.com/api-v2/panel/tracker/clone
Sustituya el hash de ejemplo por la clave hash que obtuvo anteriormente, agregue el ID de usuario de destino y el rastreador fuente, y pegue el resultado en el “Body” de la solicitud. Tenga en cuenta que solo los objetos no clonados (rastreadores fuente) pueden ser clonados.
{"hash": "1234567890abcdf1234567890abcdf", "tracker_id": 2876352, "user_id": 277617, "label": "Courier (Clone)"}Oprima el botón “Send”.
6. En este caso, he especificado el usuario de destino que proviene de otro revendedor dentro de la jerarquía de mi panel de administración. El revendedor está resaltado en la siguiente captura de pantalla:
Pero el rastreador fuente pertenece a la cuenta del panel de administración principal:
Una acción de clonación exitosa resulta en un nuevo ID de objeto (número de rastreador), que puede ser reutilizado en escenarios posteriores.
Respuesta:
{
"id": 3056626,
"success": true
}
Acceso al API para la clonación por lotes
Hemos introducido la acción de clonación por lotes. Esta llamada permite crear clones a través de la jerarquía del panel de administración principal, de manera similar a la clonación de un solo objeto. Aquí le mostramos cómo se puede realizar.
Todos los pasos anteriores son en su mayoría los mismos, excepto por la URL y los datos del “Body” (la carga útil).
La nueva acción por lotes es el método “batch clone”.
Ajustando el URL y el “Body”:
{"hash": "1234567890abcdf1234567890abcdf", "user_id": 277617, "tracker_ids": [2883610, 2887704, 2881467]}Enviar la solicitud da como resultado el siguiente ejemplo:
La respuesta contiene los ID de los rastreadores clonados que están listos para ser utilizados en el usuario de destino del revendedor mencionado anteriormente:
{
"list": [
3056696,
3056697,
3056698
],
"success": true
}
Al clonar rastreadores en modo por lotes, se conservan las etiquetas originales de los rastreadores.
Conclusión: clonación fluida y confiable
Por ejemplo, puede clonar mil rastreadores en una sola operación, eliminando la necesidad de numerosas acciones de clonación. Este enfoque minimiza la carga del API, liberando capacidad para operaciones adicionales y asegurando que los sistemas bajo alta carga continúen funcionando sin interrupciones.
La acción de clonación por lotes está diseñada para ser transaccional. Esto significa que toda la transacción se revierte si incluso un rastreador encuentra un error durante el proceso de clonación. Esta función de reversión proporciona un método altamente eficiente para gestionar grandes lotes de rastreadores, eliminando la necesidad de identificar y separar los rastreadores problemáticos de aquellos que fueron clonados con éxito.
Para obtener más detalles sobre esta función, le invitamos a visitar nuestro Portal para desarrolladores.
Si aún tiene preguntas o necesita más información, ¡estamos listos para ayudarle! Haga clic aquí para acceder a nuestros datos de contacto y comunicarse con nuestro equipo.
