Integra tus sistemas con los datos de tu operación Auvo.

• REST simple y predecible

  Endpoints organizados por dominio, verbos HTTP consistentes y envelopes de respuesta estables.

• Autenticación Bearer JWT

  Token de 30 minutos vía POST /login. Fácil de rotar, fácil de revocar. Sandbox en roadmap.

• 400 req/min por IP

  Límite de tasa claro, con estado 403 y payload JSON estandarizado. Usa paginación + backoff.

• Webhooks nativos

  Suscríbete a eventos de tareas, tickets y órdenes de servicio vía POST autenticado hacia tu URL.

• Ejemplos multi-lenguaje

  curl, Node.js, PHP, Python y Go en cada operación - copia, ejecuta y adapta.

• Changelog semanal

  Todo cambio relevante entra al changelog antes de producción, con deprecations señaladas con 90 días.

1. 1

   Obtener credenciales

   En Menú > Integración copia apiKey y apiToken. Guárdalos en un secret manager.

2. 2

   Autenticar y recibir el token

   Cambia apiKey + apiToken por un accessToken (JWT de 30 min).

   curlJavaScriptNode.jsPythonJavaC#PHPGoRuby

   Copiar

   curl -X POST https://api.auvo.com.br/v2/login \
     -H 'Content-Type: application/json' \
     -d '{"apiKey":"<YOUR_KEY>","apiToken":"<YOUR_TOKEN>"}'

3. 3

   Hacer la primera llamada autenticada

   Lista usuarios con paginación.

   curlJavaScriptNode.jsPythonJavaC#PHPGoRuby

   Copiar

   curl 'https://api.auvo.com.br/v2/users?page=1&pageSize=20' \
     -H "Authorization: Bearer $AUVO_TOKEN"

Casos de uso comunes

• Autenticación

  Flujo de login, rotación de token y buenas prácticas de secret management.

• Paginación

  Envelope pageInformation, límites y estrategias de cursor emuladas.

• Límite de tasa

  400 req/min, headers de respuesta y backoff exponencial recomendado.

• Webhooks

  Suscripción, payloads, reentrega y validación de origen.

• Errores

  Códigos HTTP, payload error, idempotencia y troubleshooting.

• Versionado

  Política de breaking changes, deprecations y canal de aviso.