Desde SAGITAZ queremos comunicaros las novedades que vendrán con la v2 del API de Zoho para que podáis estar listos cuando el cambio se efectúe.
Estos cambios empezarán a tener lugar el próximo 3 de febrero de 2021. Es recomendable no esperar a dicha fecha y comenzar a realizar la migración de la v1 lo antes posible. Según anuncia Zoho, a partir del 1 de junio, todo lo desarrollado en la v1 dejará de funcionar.
A continuación, un resumen de la comunicación desde Zoho:
¡Bienvenido a las APIs v2 de Zoho Creator!
Este post servirá como punto central para la migración de las implementaciones de las APIs actuales de Creator (v1) a la v2.
Mejoras que trae la v2
-
Autenticación basada en OAuth, que es más segura que los authtokens.
-
Soporte para los métodos PATCH y DELETE.
-
Mejor estructuración de la solicitud de la API: los datos del formulario se añadirán al cuerpo de la solicitud en formato JSON.
-
Mejor gestión de los errores gracias a un conjunto de códigos y mensajes de error más detallados.
-
Mejor rendimiento en comparación con la versión actual (v1).
-
No hay restricciones de palabras clave.
Documentación
-
Documentación.
-
La página de referencia del nombre del enlace es la misma para las API de la v2.
-
Para asegurarse de que utiliza el dominio correcto en sus solicitudes de API, se ha utilizado el término base_url en la documentación y se ha vinculado a la página de la URL base de la cuenta del Creador.
Otras cosas que hay que saber
-
Las APIs v2 sólo aceptan entradas JSON, y devuelven la respuesta en formato JSON.
-
La tasa de solicitudes es la misma para las APIs v2 también – 50 solicitudes por minuto por punto final de la API por dirección IP.
-
A diferencia de la v1, en la v2 no hay límite en el tamaño de la respuesta. Sin embargo, las APIs v2 pueden procesar un máximo de 200 registros por solicitud.
-
La API «Obtener registro – Vista detallada» no recuperará los registros mostrados en los bloques de datos relacionados (si los hay).
-
En el caso de las cuentas Creator 5, la API de obtención de registros (v1) obtiene los datos de los campos que se muestran en la vista rápida y en la vista detallada. Las APIs v2 correspondientes son específicas de la vista: Obtener registro – Vista detallada y Obtener registros – Vista rápida.
Migración a la v2
Las APIs v1 de Zoho Creator llegarán al final de su vida útil el 3 de febrero de 2021.
Por lo tanto, le recomendamos que utilice nuestras APIs v2 para las próximas implementaciones y comience a migrar sus implementaciones v1 tan pronto como sea posible.
Para migrar sus implementaciones v1 a v2, en resumen:
-
Revise las razones por las que utilizó nuestras APIs v1.
-
Identifique los ámbitos que necesitará para esas operaciones.
-
Registre las aplicaciones cliente que van a utilizar las APIs del Creador, creando credenciales de cliente para ellas.
-
Genere tokens de acceso y actualización.
-
Configure las conexiones de sus aplicaciones a Zoho Creator utilizando las correspondientes credenciales de cliente, ámbitos y tokens de acceso.
En el futuro
En un futuro próximo aprovisionaremos lo siguiente – os mantendremos informados.
-
Añadir los ámbitos de Creator a la conexión Zoho OAuth – HECHO – sobre los ámbitos.
-
v2 tareas de Deluge basadas en la API para integrar con Zoho Creator – HECHO – Documentos de ayuda.
-
APIs a granel – APIs que te permitirán procesar registros más allá del límite de 200.
Esto es todo. Una vez mas, desde SAGITAZ recomendamos que la migración se realice lo antes posible.