{"openapi":"3.1.0","info":{"title":"Turbo Station — API pública","version":"1.0.0","description":"Endpoints públicos e sem autenticação. Expõem apenas o que já é publicado em HTML no mesmo host: estações em operação e o snapshot sintético da demonstração. Não há endpoint público para iniciar, parar ou consultar recargas.","contact":{"url":"https://www.turbostation.com.br/contact"}},"servers":[{"url":"https://www.turbostation.com.br"}],"paths":{"/api/public/stations":{"get":{"summary":"Estações em operação","description":"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.","operationId":"api_public_stations","parameters":[{"name":"showcase","in":"query","required":false,"description":"Quando `true`, retorna apenas o subconjunto usado no carrossel de marketing (exclui condomínios e estações sem foto).","example":"true","schema":{"type":"string"}}],"responses":{"200":{"description":"`{ \"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.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/public/demo-station":{"get":{"summary":"Snapshot sintético de operação","description":"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.","operationId":"api_public_demo_station","parameters":[{"name":"tier","in":"query","required":false,"description":"Perfil de região a simular: `metropole_alta`, `metropole_media`, `interior` ou `litoral`. Valores inválidos caem em `metropole_alta`.","example":"interior","schema":{"type":"string"}},{"name":"seed","in":"query","required":false,"description":"Semente determinística: a mesma semente devolve o mesmo snapshot. Ausente, usa uma semente estável por dia.","example":"demo-1","schema":{"type":"string"}}],"responses":{"200":{"description":"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.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"externalDocs":{"description":"Recursos para desenvolvedores e agentes","url":"https://www.turbostation.com.br/developers"}}