Soporte para jobs desde la API y webhook

Ampliamos el soporte de la API para trabajar con jobs, es decir, procesos lanzados a través de la API que se ejecutan en segundo plano, como las actualizaciones masivas de productos.

Esto permite que una integración externa, por ejemplo un ERP, pueda enviar una operación pesada a OpenTiendas y consultar después si ha terminado correctamente, si ha terminado con errores o si ha fallado.

Nuevos endpoints

GET /api/v1/jobs/{id}

Permite consultar el estado general de un job, incluyendo el tipo de proceso, estado final, fechas de ejecución y resumen de registros procesados.

GET /api/v1/jobs/{id}/logs

Permite consultar el detalle de avisos y errores generados durante la ejecución del job. Estos logs pueden filtrarse para identificar qué registros han fallado y por qué motivo.

Nuevo webhook: job.finished

Se añade también el nuevo evento webhook job.finished, que avisa automáticamente cuando un job llega a un estado final.

De esta forma, las integraciones externas pueden recibir una notificación al finalizar el proceso sin tener que consultar periódicamente la API.

El webhook se envía cuando el job finaliza correctamente, finaliza con errores o falla durante el procesamiento. El resultado final debe revisarse en el estado del job.

👌 Más detalles en el blog técnico

Consulta el blog de opentiendas.dev para ver más información sobre jobs, logs y webhooks de finalización. Última versión de la API 1.2.8.

👌 API en constante mejora

Como parte del proceso periódico de mejora de la API, se han incorporado nuevas explicaciones en la documentación y nuevas validaciones en varios endpoints, con el objetivo de hacer las integraciones más claras, seguras y robustas.