El objetivo de este post es enfocarnos en la migración de las implementaciones de las API actuales de Creator (v1) a la v2.
Mejoras de 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 agregarán al cuerpo de la solicitud en formato JSON
- Mejor manejo de errores como resultado de un conjunto más detallado de códigos y mensajes de error
- Mejor rendimiento en comparación con la versión actual (v1)
- Sin restricciones de palabras clave
Documentación
- Documentación
- El nombre del link de la página de referencia es el mismo para la v2 de las API
- Para asegurarte de que utilizas el dominio correcto en tus solicitudes de API, el término base_url se ha utilizado en la documentación y se ha vinculado a la URL de la página base de la cuenta de Creator.
Otras cosas que saber
- Las API v2 solo aceptan entradas JSON y devuelven la respuesta en formato JSON
- La tasa de solicitud es la misma para las API v2 también: 50 solicitudes por minuto por endpoint de API por dirección IP
- A diferencia de en la v1, no hay límite para el tamaño de respuesta en la v2. Sin embargo, las API v2 pueden procesar un máximo de 200 registros por solicitud
- La API Get Record – Detail View API no buscará los registros que se muestran en los bloques de datos relacionados (si los hubiera)
- Para las cuentas de Creator 5, la API de registros de vista (v1) obtiene datos de los campos que se muestran en la vista rápida y la vista detallada. Las API v2 correspondientes son vistas específicas: Get Record – Detail View y Get Records – Quick View.
Migración a v2
Las API v1 de Zoho Creator llegarán al final de su vida útil el 3 de febrero de 2021. Por lo tanto, recomendamos utilizar las API v2 para las próximas implementaciones y comenzar a migrar sus implementaciones v1 lo antes posible.
Para migrar tus implementaciones v1 a v2, en resumen:
- Revisa las razones por las que utilizaba las API v1
- Identifica los alcances que necesitarás para esas operaciones
- Registra las aplicaciones del cliente que van a utilizar las API de Creator, para crear las credenciales de cliente para ellas
- Genera tokens de acceso y actualización
- Configura conexiones desde tus aplicaciones a Zoho Creator utilizando las credenciales de cliente, alcances y tokens de acceso correspondientes.
Para seguir avanzando
Proporcionaremos los siguientes pasos más adelante:
- Agregar los alcances de Creator a la conexión de Zoho OAuth
- Tareas de Deluge basadas en API v2 para integrar con Zoho Creator
- API masivas: API que permitirán procesar registros más allá del límite de 200
Si necesitas ayuda para hacer un estudio de tus APIs y realizar el cambio en el caso de que sea necesario, no dudes en contactarnos!