Recetas de API: integraciones habituales

Patrones prácticos que puedes construir sobre la API de Roldesk. Todos los endpoints están bajo https://www.roldesk.com/api/v1.

Mantén los clientes sincronizados

Trae los cambios desde tu última sincronización e insértalos o actualízalos en tu CRM o sistema de contabilidad:

GET /customers?updated_since=2026-08-01T00:00:00Z&limit=100

Pagina con next_cursor hasta que has_more sea falso. Para enviar un cliente nuevo a Roldesk, usa POST /customers. Usa un Idempotency-Key para que las repeticiones nunca dupliquen.

Crea una orden de trabajo desde un disparador externo

Cuando entra un ticket o un formulario, abre un trabajo:

POST /work-orders
{ "priority": "HIGH",
  "problem": { "title": "El aire no enfría", "description": "…" },
  "account_id": "…" }

Envía facturas a tu contabilidad

Lee las facturas a medida que se crean (mediante el webhook invoice.created o GET /invoices?status=…) y refléjalas en tu sistema de contabilidad. Roldesk calcula los totales, así que puedes confiar en subtotal, tax y total.

Evita conflictos en las actualizaciones

Al actualizar un registro, incluye expected_updated_at (el valor que leíste por última vez). Si alguien lo cambió antes, obtendrás un 409 en lugar de sobrescribir su edición: vuelve a cargarlo y reinténtalo.

Respeta los límites de frecuencia

Cada token permite 100 peticiones cada 10 segundos y 5.000 por hora. Cada respuesta incluye X-RateLimit-Remaining; reduce el ritmo cuando esté bajo. Prefiere los webhooks antes que el sondeo frecuente.

Consulta la referencia completa e importa la especificación OpenAPI en tus herramientas.