API e MCP

Leitura pública, sem cadastro. Use com moderação; os dados mudam a cada poucos minutos.

Servidor MCP

Endereço: https://caiuaqui.com.br/mcp (HTTP, sem autenticação). Ferramentas:

  • buscar_servico: encontra o serviço pelo nome.
  • status_servico: estado atual, relatos, sintomas e posição oficial.
  • incidentes_ativos: serviços com problemas e áreas afetadas agora.

API (JSON)

  • GET https://caiuaqui.com.br/api/services: todos os serviços e o estado atual.
  • GET https://caiuaqui.com.br/api/services/{slug}/status: detalhe de um serviço.
  • GET https://caiuaqui.com.br/api/incidents: incidentes abertos.
  • GET https://caiuaqui.com.br/api/areas: áreas afetadas por falta de luz, água ou internet (GeoJSON).
  • GET https://caiuaqui.com.br/api/map: regiões do mapa com relatos (GeoJSON).

Para empresas

Empresas com conta verificada publicam comunicados nos próprios serviços. O comunicado aparece na página do serviço e, se indicado, na página da área afetada.

  • POST https://caiuaqui.com.br/api/company/updates com o cabeçalho Authorization: Bearer <token> e corpo { "service": "slug", "body": "texto", "area_id": "opcional", "automated": false }.
  • Respostas geradas por robô ou regra automática devem enviar "automated": true e são rotuladas.
  • Quem não programa pode fazer o mesmo pelo navegador, na Área da empresa.
  • A empresa não remove nem altera relatos de usuários.

Como citar

Os indicadores refletem relatos de usuários e verificações automáticas, não a posição oficial das empresas. Ao exibir estes dados, mantenha essa ressalva e indique o Caiu Aqui como fonte.