Pular para o conteudo principal
API

Integre seu sistema com a AVIVA

API REST completa, SDKs oficiais e documentacao detalhada para conectar seu sistema ao AVIVA Gestão. Construa integracoes poderosas em minutos.

Tudo que voce precisa para integrar

Ferramentas e recursos pensados para facilitar o desenvolvimento de integracoes.

REST API

API RESTful completa com endpoints para agendamentos, pacientes, prontuarios, financeiro e muito mais. Respostas em JSON padronizado.

Webhooks

Receba notificacoes em tempo real sobre eventos da plataforma. Mais de 20 tipos de eventos com retry automatico e logs detalhados.

SDKs (Node.js / Python)

Bibliotecas oficiais para Node.js e Python com tipagem completa, tratamento de erros e exemplos prontos para uso.

Sandbox / Testes

Ambiente sandbox completo para desenvolvimento e testes. Dados ficticios pre-populados e sem impacto na producao.

Rate Limiting Generoso

Ate 1.000 requisicoes por minuto no plano Pro e 5.000 no Enterprise. Headers informativos para controle de consumo.

Documentacao OpenAPI

Especificacao OpenAPI 3.0 completa com Swagger UI interativo. Teste endpoints diretamente no navegador.

Simples de usar

Faca sua primeira chamada a API em segundos com um simples comando curl.

Terminal
# Listar agendamentos do dia
curl -X GET \
  'https://api.avivapsicologia.com.br/v1/appointments?date=2026-03-15' \
  -H 'Authorization: Bearer SUA_API_KEY' \
  -H 'Content-Type: application/json'

# Resposta
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "patient": { "name": "Maria Silva" },
      "professional": { "name": "Dr. Joao Santos" },
      "scheduled_at": "2026-03-15T09:00:00-03:00",
      "status": "confirmed",
      "is_online": false
    }
  ],
  "meta": { "total": 1, "page": 1, "per_page": 20 }
}

Autenticacao via API Keys

A API do AVIVA utiliza API Keys para autenticacao. Cada chave esta vinculada a um tenant e possui permissoes configuráveis para controle granular de acesso.

  • Gerencie suas API Keys pelo painel do desenvolvedor
  • Permissoes granulares por recurso (leitura, escrita)
  • Chaves de producao e sandbox separadas
  • Rotacao de chaves sem downtime
  • Logs de uso detalhados por chave
  • Suporte a Bearer Token (JWT) para aplicacoes web
# Autenticacao com API Key
curl -X GET \
  'https://api.avivapsicologia.com.br/v1/patients' \
  -H 'X-API-Key: aviva_sk_live_...' \
  -H 'Content-Type: application/json'

# Autenticacao com Bearer Token
curl -X GET \
  'https://api.avivapsicologia.com.br/v1/patients' \
  -H 'Authorization: Bearer eyJhbG...' \
  -H 'Content-Type: application/json'

Pronto para construir sua integracao?

Crie sua conta, gere sua API Key e faca sua primeira chamada em menos de 5 minutos.