Pular para o conteúdo
API em produção - base https://api.auvo.com.br/v2

Integre seus sistemas aos dados da sua operação Auvo.

O Portal do Desenvolvedor Auvo reúne toda a documentação da API REST v2.0 em um só lugar - autenticação, referência completa dos endpoints, exemplos prontos em cURL e webhooks para conectar o Auvo ao seu ERP, BI ou aplicação interna.

de recursos na API v2
28grupos
REST documentados
141endpoints
rate limit por IP
400req/min
operando com Auvo
16países

Desenhado para integrações de campo

Fluxos otimizados para workforce, operações e financeiro - as mesmas primitivas usadas no app Auvo.

  • REST simples e previsível

    Endpoints organizados por domínio, verbos HTTP consistentes e envelopes de resposta estáveis.

  • Autenticação Bearer JWT

    Token de 30 minutos via POST /login. Fácil de rotacionar, fácil de revogar. Sandbox em roadmap.

  • 400 req/min por IP

    Rate limit claro, com status 403 e payload JSON padronizado. Use paginação + backoff.

  • Webhooks nativos

    Assine eventos de tarefas, tickets e ordens de serviço via POST autenticado para a sua URL.

  • Exemplos multi-linguagem

    curl, Node.js, PHP, Python e Go em cada operação - copie, rode e adapte.

  • Changelog semanal

    Toda mudança relevante entra no changelog antes de ir a produção, com deprecations sinalizadas com 90 dias.

Quickstart em 3 passos

Autentique, liste usuários e registre sua primeira tarefa.

  1. Obter credenciais

    Em Menu > Integração copie apiKey e apiToken. Mantenha em um secret manager.

  2. Autenticar e receber o token

    Troque apiKey + apiToken por um accessToken (JWT 30 min).

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

  3. Fazer a primeira chamada autenticada

    Liste usuários com paginação.

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

Casos de uso comuns

Trilhas de guides

  • Autenticação

    Fluxo de login, rotação de token e boas práticas de secret management.

  • Paginação

    Envelope pageInformation, limites e estratégias de cursor emuladas.

  • Rate limit

    400 req/min, headers de resposta e backoff exponencial recomendado.

  • Webhooks

    Assinatura, payloads, reentrega e validação de origem.

  • Erros

    Códigos HTTP, payload error, idempotência e troubleshooting.

  • Versionamento

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

Pronto para integrar?

Acesse a referência completa ou envie uma dúvida para help@auvo.com.br.