En el siguiente artículo enumeramos algunos requisitos que consideramos clave para una implementación técnica que sea robusta y optimizada. Te invitamos a conocer el detalle de cada uno y tenerlos en cuenta durante el desarrollo de tu integración.
- Implementación de Polling y Webhooks
Es obligatorio implementar tanto los endpoints de polling como los webhooks para la lectura de los recursos.
Los webhooks actuarán como el canal principal para recibir notificaciones sobre la creación o actualización de recursos. Por su parte, los pollings deberán ser utilizados como mecanismo de respaldo, asegurando la recuperación de cualquier notificación que no haya sido recibida correctamente a través de los webhooks.
Nota: En el caso de los sistemas que son canales de ventas los polling que se deben habilitar son: checkouts, products, stock, prices y product links. Esto para garantizar la sincronización de la información asociada a todo el ciclo de venta del producto.
Puedes conocer el detalle de estas funcionalidades en los siguientes artículo:
- Todo lo que necesitas saber sobre Webhooks: Configuración y Uso
- Endpoints para Realizar Polling Disponibles en Nuestra API
2. La URL de callback debe recibir los webhooks o notificaciones y responder a la recepción del evento en un tiempo máximo de 6 segundos.
3. El procesamiento detallado de las notificaciones debe realizarse en segundo plano, idealmente mediante un sistema de colas para gestionar la información del webhook.
4. Se requiere la implementación de un control de errores HTTP estándar en los llamados que se realizan a nuestras APIs, con el objetivo de asegurar que la ausencia de validaciones ante respuestas imprevistas del servicio no comprometa la operatividad de los procesos de la API. (Errores HTTP estándar).
5. Es responsabilidad del equipo de integración asegurar que su equipo y el merchant conozcan a fondo tanto el proceso de autorización de la aplicación como la subsiguiente generación del código de autorización tras la conexión de la aplicación.
6. Es crucial que la aplicación implemente el refresco del token, prestando especial atención a detalles relevantes como los tiempos de caducidad, el uso de parámetros específicos, las estrategias de almacenamiento y el manejo de errores (detalles completos en el artículo adjunto).
7. Para facilitar el seguimiento y la resolución de cualquier eventualidad en la integración, es crucial que los integradores implementen un sistema robusto de registro de logs que permita la trazabilidad completa de los procesos.
8. Es importante tener en consideración que tenemos un límite de 5 peticiones por segundo (Rate Limit) para asegurar un servicio óptimo. Exceder este límite podría llevar a una restricción temporal de tus peticiones.
Equipo Integraciones API Multivende
0 comentarios
Inicie sesión para dejar un comentario.