Endpoints
| Método | Caminho | O que retorna |
|---|---|---|
GET | /api/v1/index.json | Ponto de entrada: lista os endpoints e a data de geração. |
GET | /api/v1/empresas.json | Todas as empresas (campos públicos da ficha). |
GET | /api/v1/empresas/{slug}.json | Uma empresa pelo slug da URL da ficha. |
GET | /api/v1/categorias.json | Categorias e subcategorias com contagem real. |
GET | /api/v1/categorias/{slug}.json | Empresas de uma categoria. |
GET | /api/v1/bairros.json | Bairros com contagem de empresas e centro OSM quando confirmado. |
GET | /api/v1/mapa.json | Dados do mapa: pins verificados e grupos por bairro. |
GET | /api/v1/busca.json | Índice compacto usado pela busca do site. |
GET | /api/v1/noticias.json | Manchetes oficiais da Prefeitura (RSS), com link e data. |
GET | /api/openapi.json | Especificação OpenAPI 3.1. |
GET | /llms.txt | Resumo do site para modelos de linguagem. |
Arquivos estáticos gerados no build a partir do cadastro do guia. CORS liberado (Access-Control-Allow-Origin: *), cache de 1 hora na CDN. Campos ausentes na ficha simplesmente não aparecem no JSON — nada é preenchido por estimativa.
Exemplo
curl https://mapsweb.com.br/api/v1/empresas/esgotec-limpa-fossa-e-desentupidora.json{
"slug": "esgotec-limpa-fossa-e-desentupidora",
"nome": "ESGOTEC - LIMPA FOSSA E DESENTUPIDORA",
"url": "https://mapsweb.com.br/ms/tres-lagoas/esgotec-limpa-fossa-e-desentupidora/",
"api": "https://mapsweb.com.br/api/v1/empresas/esgotec-limpa-fossa-e-desentupidora.json",
"categoria": {
"slug": "servicos",
"nome": "Serviços"
},
"subcategoria": {
"slug": "limpa-fossa-e-desentupidora",
"nome": "Limpa fossa e desentupidora"
},
"atividade_cnae": {
"codigo": "3702900",
"descricao": "Atividades relacionadas a esgoto, exceto a gestão de redes"
},
"endereco": {
"logradouro": "Av. Prof. João Thomes, 1008",
"complemento": null,
"bairro": "Jardim Alvorada",
"cep": "79610-180",
"cidade": "Três Lagoas",
"uf": "MS"
},
"bairro": "Jardim Alvorada",
"telefone": "(67) 99219-7775",
"whatsapp": "+5567992197775",
"horario": [
[
"Domingo",
"Fechado"
],
[
"Segunda-feira",
"07:30–17:00"
],
[
"Terça-feira",
"07:30–17:00"
],
[
"Quarta-feira",
"07:30–17:00"
],
[
"Quinta-feira",
"07:30–17:00"
],
[
"Sexta-feira",
"07:30–17:00"
],
[
"Sábado",
"07:30–11:00"
]
],
"descricao": "A Esgotec é a desentupidora de referência em Três Lagoas, fornecendo serviços profissionais de desentupimento e limpa fossa em Três Lagoas. Contamos com uma equipe altamente qualificada e experiente para lidar com todos os tipos de entupimentos de esgoto, assegurando um serviço eficiente e de qualidade. Além disso, oferecemos limpeza de fossas com preços competitivos e um atendimento ágil. Se você está enfrentando problemas de entupimento ou precisa de serviços de limpeza de fossa, a Esgotec é a escolha certa em Três Lagoas. Entre em contato conosco para resolver seus problemas de forma eficaz e profissional.",
"redes": {
"instagram": "https://www.instagram.com/esgotectl/"
},
"fotos": [
"https://mapsweb.com.br/img/empresas/esgotec-limpa-fossa-e-desentupidora-cover-609.webp"
],
"cnpj": "09.136.712/0001-07",
"destaque": false,
"ficha_reivindicada": true,
"atualizado_em": "2026-10-11",
"criado_em": "2026-08-29"
}Acesso premium com HTTP 402 / x402 (futuro, desativado)
A API pública continua gratuita. Está preparada uma rota futura /api/v2/premium/* (ex.: dados enriquecidos ou consultas em lote) que poderá responder 402 Payment Required no padrão x402: o servidor devolve o cabeçalho PAYMENT-REQUIRED, o agente paga e repete a chamada com PAYMENT-SIGNATURE, e a resposta traz PAYMENT-RESPONSE.
Hoje nenhum endpoint cobra nada, não há carteira configurada e nenhuma rota responde 402. O passo a passo para ativar está em docs/FUTURO.md do projeto.