Este Data Connector viene incluido en la licencia de Graphics. NO requiere el pago de una tarifa adicional.
El Data Connenctor JSON Get usa un método GET para solicitar contenido de una URL, esperando un archivo JSON en la URL proporcionada.
Agregar el Data Connector al Editor de Gráficos
Primero necesitas agregar un Data Connector a tu árbol (1) y hacer clic en Conectar desde el panel Conector externo del Inspector (2)
Desde el panel Fuente externa, encontrarás múltiples opciones, escoge JSON Get
Se te pedirá que agregues la URL que aloja el contenido JSON, pero antes de agregar la URL, podrás seleccionar cómo controlar la actualización de datos. Eso significa que tú controlas cuándo se actualizan los datos, ya sea sincronizando desde el control remoto (Attended) o actualizando automáticamente los datos periódicamente (Unattended).
En este ejemplo, usamos la siguiente URL: https://api.npoint.io/e9cd5ed0e0c0f3fcfdfc
Detalles sobre la autenticación
Si bien algunas API están disponibles públicamente, hay otras que requieren autenticación. Ten en cuenta:
- El identificador de la aplicación o el token de autenticación deben agregarse a la URL.
- No se admite la autenticación basada en encabezados
Una vez que hayas agregado la URL, el esquema se generará automáticamente y se mostrará en un campo editable.
Una vez que presionas crear, la URL y el esquema se almacenan en la configuración del conector, lo que te permite cambiarlos más tarde.
Estilo de adquisición: Attended Vs Unattended
Al seleccionar Adquisición attended, necesitas hacer clic en 'Sincronizar ahora' en cualquier momento para traer contenido actualizado de la API.
Si eliges Adquisición unattended, los datos se actualizarán automáticamente al menos 30 segundos después de que se actualice el contenido de la API. El tiempo máximo entre adquisiciones es de 600 segundos, esto es configurable en el campo de período de adquisición:
Esquema JSON
Aunque el esquema JSON se deduce automáticamente, necesitas revisarlo. En el caso de las URL de imágenes, probablemente se inferirán como una cadena y no como ImageUrL. Para recuperar imágenes provenientes de una URL, necesitas cambiar el esquema de "tipo": "string" a "tipo": "ImageUrl"
Con los datos ahora configurados, puedes comenzar a crear tu árbol con nuestros building blocks, vincular contenido y formatear los gráficos. En este ejemplo, usamos la siguiente URL de la API anterior.
https://api.npoint.io/e9cd5ed0e0c0f3fcfdfc
En el ejemplo, creamos un "Scorebug" para un partido de Baseball con la informacion del Json anterior.