Primeros pasos con la API de Roldesk

La API REST de Roldesk permite que tus otros programas lean y actualicen los datos de tu espacio de trabajo: órdenes de trabajo, clientes, facturas, contratos y más. Está disponible en el plan Professional.

1. Crea un token de acceso

Ve a Ajustes → Desarrollador (solo propietario o administrador) y crea un token de acceso personal. Elige los permisos que necesita; por ejemplo, crm:read para leer clientes o work-orders:write para crear trabajos. Copia el token ahora: solo se muestra una vez.

2. Verifica que funciona

Envía el token como encabezado Bearer. El endpoint /me confirma el token y muestra tu espacio de trabajo:

curl https://www.roldesk.com/api/v1/me \
  -H "Authorization: Bearer rk_live_…"

3. Lee algunos datos

curl "https://www.roldesk.com/api/v1/work-orders?limit=25" \
  -H "Authorization: Bearer rk_live_…"

Las listas están paginadas: pasa limit (hasta 100) y el next_cursor de la respuesta anterior para obtener la página siguiente. Puedes filtrar con status, account_id y updated_since.

4. Crea o actualiza datos

curl -X POST https://www.roldesk.com/api/v1/customers \
  -H "Authorization: Bearer rk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corp", "email": "ops@acme.com"}'

Añade un encabezado Idempotency-Key para reintentar de forma segura sin crear duplicados.

Adónde ir después

• Referencia completa: roldesk.com/developers
• Importar a Postman/Insomnia: la especificación OpenAPI en /api/v1/openapi.json
• Eventos en tiempo real: consulta el artículo sobre Webhooks.