Turbo Station — API pública e recursos para desenvolvedores

Endpoints públicos sem autenticação, especificação OpenAPI, negociação de conteúdo em Markdown e os arquivos que descrevem este site para assistentes e agentes.

Endpoints públicos

Estações em operação

GET https://www.turbostation.com.br/api/public/stations

Lista as estações de recarga em produção da marca resolvida pelo hostname da requisição. É a mesma fonte que alimenta o mapa público da página inicial. Sem autenticação e sem dados pessoais: não retorna proprietário, contrato, receita nem qualquer identificador de cliente.

?showcase=true: — Quando `true`, retorna apenas o subconjunto usado no carrossel de marketing (exclui condomínios e estações sem foto).

Retorna: `{ "stations": Station[] }`, onde cada Station traz id, nome, localização, cidade, UF, horário, potência em kW, preço por kWh, coordenadas e URL de rota no Google Maps.

Snapshot sintético de operação

GET https://www.turbostation.com.br/api/public/demo-station

Retorna o snapshot fabricado que alimenta a demonstração pública do painel em /demo: um cartão de estação, transações sintéticas recentes e uma série diária de 14 dias. Nenhum dado é real — os números derivam de medianas de rede já agregadas (N≥5, sem PII) e de preenchimento determinístico. Limitado a 30 requisições por minuto por IP.

?tier=interior: — Perfil de região a simular: `metropole_alta`, `metropole_media`, `interior` ou `litoral`. Valores inválidos caem em `metropole_alta`.
?seed=demo-1: — Semente determinística: a mesma semente devolve o mesmo snapshot. Ausente, usa uma semente estável por dia.

Retorna: Um snapshot de demonstração com o cartão da estação, as transações sintéticas e a série diária de 14 dias.

A especificação legível por máquina está em /openapi.json (OpenAPI 3.1).

Conteúdo em Markdown

Toda página pública deste site responde em Markdown quando a requisição negocia o formato. A resposta traz Content-Type: text/markdown; charset=utf-8 e Vary: Accept.

curl -H "Accept: text/markdown" https://www.turbostation.com.br/about

O mesmo conteúdo também tem uma URL estável, para quando o cabeçalho não sobrevive a um proxy:

curl https://www.turbostation.com.br/md/about

Q-values são respeitados: um cliente que classifica HTML acima de Markdown recebe HTML. Uma requisição que não aceita nem text/html nem text/markdown recebe 406 Not Acceptable. Caminhos inexistentes respondem 404 com um corpo em Markdown que aponta para os índices do site.

Arquivos de descoberta

/llms.txt — Índice do site para assistentes, com as perguntas que sabemos responder.
/agent-instructions.md — Quando acionar a rede, quando não acionar, e como chamar.
/openapi.json — Especificação OpenAPI 3.1 dos endpoints acima.
/sitemap.xml — Lista canônica de todas as URLs públicas.
/robots.txt — Regras de rastreamento.

Limites e o que não existe

Não existe endpoint público para iniciar, parar ou consultar uma recarga — isso exige conta autenticada no aplicativo.
Não existe endpoint público de preços históricos, faturamento ou telemetria de carregador.
Não há chave de API e não há autenticação; em troca, os endpoints expõem apenas o que já é público em HTML no mesmo host.
As respostas são cacheadas na borda por 60 segundos. Faça polling com parcimônia.