API para desenvolvedores

Comece em cinco minutos

1. Peça um usuário de integração ao administrador da prefeitura em Painel › Administração › Usuários(papel OPERADOR para consultar, GESTOR para movimentar, ADMIN para cadastros e exportação). Consultas públicas (mapa, protocolo, dados abertos) não precisam de login.
2. Faça login em POST /api/v1/auth/login e guarde o token (JWT).
3. Envie o token em Authorization: Bearer <token> e o município em X-Municipio: <slug> em toda chamada.
4. Explore a referência interativa: ela gera o código em curl, JavaScript, Python, PHP, Java e outros, e permite testar cada chamada aqui mesmo.

Erros

Toda falha vem com o mesmo corpo: { "erro": "mensagem legível", "detalhes": ... }. Em 422, detalhes traz os erros por campo ({ "campo": ["mensagem"] }).

Exemplos com curl

curl -X POST https://taresolvido.app.br/api/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"login": "operador@manaus.taresolvido.app.br", "senha": "•••••••"}'

# resposta: { "token": "eyJhbGciOi...", "usuario": { "nome": "...", "membros": [ { "papel": "OPERADOR", ... } ] } }
export TOKEN="eyJhbGciOi..."

curl https://taresolvido.app.br/api/v1/ocorrencias/MAO-2026-000123 -H 'X-Municipio: manaus'

curl "https://taresolvido.app.br/api/v1/ocorrencias?status=RECEBIDA,EM_ANALISE,EM_EXECUCAO&perPage=50&page=1" \
  -H 'X-Municipio: manaus'

curl -X POST https://taresolvido.app.br/api/v1/ocorrencias \
  -H "Authorization: Bearer $TOKEN" -H 'X-Municipio: manaus' -H 'Content-Type: application/json' \
  -d '{
    "categoriaId": "<id da categoria>",
    "descricao": "Buraco grande na pista, em frente ao nº 1200",
    "lat": -3.1019, "lng": -60.0250,
    "endereco": "Av. Djalma Batista, 1200",
    "anonima": false
  }'

curl -X PATCH https://taresolvido.app.br/api/v1/ocorrencias/<id>/status \
  -H "Authorization: Bearer $TOKEN" -H 'X-Municipio: manaus' -H 'Content-Type: application/json' \
  -d '{"status": "EM_EXECUCAO", "mensagem": "Equipe da SEMINF programada para amanhã pela manhã."}'

# transparência (público, anonimizado)
curl "https://taresolvido.app.br/api/v1/dados-abertos/ocorrencias.csv?municipio=manaus" -o ocorrencias-manaus.csv

# exportação integral (ADMIN)
curl "https://taresolvido.app.br/api/v1/admin/exportacao/completo.json" \
  -H "Authorization: Bearer $TOKEN" -H 'X-Municipio: manaus' -o manaus-completo.json

curl https://taresolvido.app.br/api/v1/openapi.json -o taresolvido-openapi.json
npx @openapitools/openapi-generator-cli generate -i taresolvido-openapi.json -g typescript-fetch -o ./sdk