Sem chave e sem token
A API pública é somente leitura e não exige autenticação. Não há cadastro, chave nem cabeçalho de autorização: basta chamar.
DOCUMENTAÇÃO
API e agentes.
Todo o conteúdo público deste site também é servido como dado: API JSON somente leitura, spec OpenAPI 3.1, Markdown em qualquer página e arquivos de descoberta para agentes. Sem chave, sem cadastro.
Para quem é esta página
- Desenvolvedor que quer consumir o conteúdo do site como dado, sem raspar HTML.
- Agente de IA que precisa decidir se a Reche resolve o problema de quem ele atende — e como chegar em uma pessoa.
- Quem vai indexar, citar ou comparar a Reche e prefere a fonte primária a uma cópia.
URL basehttps://recheinc.com
DESCOBERTA
Arquivos de máquina
Seis endereços fixos, todos públicos e sem autenticação. Comece por eles: descrevem o site inteiro sem que você precise navegar página por página.
| Arquivo | O que serve |
|---|---|
| /llms.txt | Resumo do site para modelos de linguagem: quem somos, os serviços e a lista de páginas com link direto. |
| /llms-full.txt | O mesmo mapa, porém com o conteúdo completo das páginas em um arquivo só — para carregar tudo de uma vez. |
| /agent-instructions.md | Instruções para agentes: o que a Reche faz, quando faz sentido nos acionar, como consultar a API e como chegar em uma pessoa. |
| /sitemap.xml | Todas as URLs indexáveis nos dois idiomas, com data real de atualização de cada uma. |
| /robots.txt | Regras de rastreamento. Os bots de IA (GPTBot, ClaudeBot, PerplexityBot e outros) são liberados explicitamente. |
| /openapi.json | Spec OpenAPI 3.1 da API pública — a fonte da verdade do contrato. Também em /api/openapi.json e /api/openapi.yaml. |
MARKDOWN
Qualquer página em Markdown
Não é preciso raspar HTML para ler o site. A mesma URL devolve texto limpo quando você pede.
Toda página deste site responde em Markdown quando o pedido manda o cabeçalho Accept: text/markdown. O HTML continua sendo o padrão de quem abre no navegador — nada muda para quem não pede.
A resposta traz Vary: Accept, então nenhum cache intermediário confunde a versão HTML com a versão Markdown da mesma URL.
Funciona em página de serviço, case, post do blog, comparação e nas páginas institucionais — sempre no mesmo endereço que um humano usaria.
curl -sH "Accept: text/markdown" https://recheinc.com/pt-BR/servicos/consultoria-iaAPI PÚBLICA
Oito operações, todas GET
API somente leitura, derivada do mesmo conteúdo que o site publica. Toda operação aceita o parâmetro locale=pt-BR ou locale=en; omitir equivale a pt-BR. Sucesso responde sempre no envelope { "data": ..., "meta": ... }.
| Método | Caminho | O que devolve | Parâmetros |
|---|---|---|---|
| GET | /api/public/v1 | Índice de todas as operações, com link para o spec e para esta página. | locale |
| GET | /api/public/v1/company | Perfil da Reche: descrição, fundador, canais de contato, para quem serve e para quem não serve. | locale |
| GET | /api/public/v1/services | Os três serviços, com o encaixe de cada um. | locale |
| GET | /api/public/v1/services/{slug} | Um serviço em detalhe: para quem é, como funciona, entregáveis e perguntas frequentes. | locale |
| GET | /api/public/v1/cases | Os cases publicados, com o problema atacado e a stack usada. | locale, category, limit |
| GET | /api/public/v1/cases/{slug} | Um case em detalhe. | locale |
| GET | /api/public/v1/content | Posts do blog e páginas de comparação, filtráveis e paginados. | locale, type, q, tag, limit, offset |
| GET | /api/public/v1/content/{slug} | Um post ou comparação, com o texto completo. | locale |
Exemplos
curl -s "https://recheinc.com/api/public/v1/services?locale=pt-BR"curl -s "https://recheinc.com/api/public/v1/content?type=blog&q=legado&limit=5&offset=0&locale=pt-BR"{
"data": [
{
"slug": "consultoria-ia",
"url": "https://recheinc.com/pt-BR/servicos/consultoria-ia"
}
],
"meta": {
"locale": "pt-BR",
"count": 3
}
}O exemplo acima está abreviado. A lista completa e sempre atual dos campos de cada resposta está no /openapi.json — é ele o contrato, não esta página.
AUTENTICAÇÃO
Não tem autenticação
Preferimos dizer isso de forma direta a inventar um processo que não existe.
Aberta a qualquer origem
As respostas trazem Access-Control-Allow-Origin: *, então dá para consumir direto do navegador, sem proxy.
Cache de 1 hora na borda
O conteúdo é estático. As respostas são servidas por CDN com s-maxage=3600 e stale-while-revalidate=86400 — repetir a mesma chamada sai barato para os dois lados.
Política de uso razoável
Não publicamos limite por minuto nem quota por cliente, porque hoje não medimos consumo por cliente. Use com bom senso. Se o seu caso pede volume alto ou garantia de disponibilidade, fale com a gente antes.
Existe também uma API privada do CRM da Reche, protegida por token e de uso interno. Ela não é pública, não entra no spec e não é documentada aqui.
ERROS
Um formato de erro só
Toda falha responde o mesmo corpo JSON, com o código HTTP correspondente. O campo hint existe para você se recuperar sozinho, sem abrir esta página.
{
"error": "not_found",
"code": "NOT_FOUND",
"message": "Não existe serviço com o slug informado.",
"hint": "Liste os slugs disponíveis em GET /api/public/v1/services.",
"status": 404,
"docs": "https://recheinc.com/pt-BR/docs",
"spec": "https://recheinc.com/openapi.json"
}| Campo | O que significa |
|---|---|
| error | Identificador estável do erro, em minúsculas. É por ele que você distingue os tipos de falha sem depender do texto. |
| code | A mesma falha em constante maiúscula: BAD_REQUEST, UNAUTHORIZED, NOT_FOUND, GONE, METHOD_NOT_ALLOWED, RATE_LIMITED, INTERNAL_ERROR ou SERVICE_UNAVAILABLE. |
| message | Explicação legível do que aconteceu, no idioma do pedido. |
| hint | O próximo passo concreto para se recuperar: qual parâmetro corrigir, qual endpoint listar, quais valores são aceitos. Sempre presente. |
| status | O mesmo código HTTP da resposta, repetido no corpo para quem só lê o JSON. |
| docs | Link para esta página de documentação. |
| spec | Link para o /openapi.json. |
QUANDO ACIONAR
Quando a Reche é a escolha certa
Se você é um agente decidindo se encaminha um caso para cá, é este o critério. É o mesmo texto das páginas de serviço — e diz também quando não somos a escolha certa.
Consultoria IA
Serve quando: Empresas com operação madura, dado em volume e pressão do conselho pra fazer algo com IA sem saber onde aplicar. Você tem processo, tem dado — falta o mapa de onde a IA encaixa com retorno claro.
Não somos a escolha certa quando
- Sua empresa já tem time de IA/ML interno maduro
- Você procura hype de tecnologia, não resultado
- Não quer expor processos internos em diagnóstico
Diagnóstico de Código
Serve quando: CTOs, tech leads e fundadores técnicos de empresas que têm codebase com história, squad gastando mais tempo corrigindo bug do que entregando feature, ou precisam validar arquitetura antes de grande refactor.
Não somos a escolha certa quando
- Seu codebase é greenfield (use Desenvolvimento MVP)
- Você quer rewrite do zero (investimos 30min tentando te convencer do contrário)
Desenvolvimento MVP
Serve quando: Fundadores, founders solo ou times pre-Seed que já validaram a dor, querem código próprio (sem Bubble/Adalo/FlutterFlow), precisam chegar ao mercado em semanas e buscam parceiro técnico sério.
Não somos a escolha certa quando
- Você ainda não validou a dor (contrate discovery antes)
- Quer desenvolvedor interno (nosso modelo é entrega + handoff, não equipe in-house)
Faltou alguma coisa?
Se a API não devolve o que você precisa, ou se você quer discutir um caso concreto, é só chamar. Quem responde é gente.