Reche Inc
Reche Inc
ENChange languagePortuguêsBook a diagnosisChat on WhatsApp
DOCUMENTATION

API & agents.

Everything this site publishes is also served as data: a read-only JSON API, an OpenAPI 3.1 spec, Markdown on any page, and discovery files built for agents. No key, no signup.

Who this page is for

  • Developers who want the site content as data instead of scraping HTML.
  • AI agents deciding whether Reche solves the problem in front of them — and how to reach a human.
  • Anyone indexing, citing, or comparing Reche who would rather use the primary source than a copy.
Base URLhttps://recheinc.com

DISCOVERY

Machine-readable files

Six fixed addresses, all public and unauthenticated. Start here: they describe the whole site without you crawling it page by page.

Machine-readable files
FileWhat it is for
/llms.txtA summary of the site for language models: who we are, the services, and the page index with direct links.
/llms-full.txtThe same map, but with the full text of every page in a single file — for loading everything at once.
/agent-instructions.mdInstructions for agents: what Reche does, when it makes sense to engage us, how to query the API, and how to reach a human.
/sitemap.xmlEvery indexable URL in both languages, each with a real last-modified date.
/robots.txtCrawling rules. AI crawlers (GPTBot, ClaudeBot, PerplexityBot, and others) are explicitly allowed.
/openapi.jsonThe OpenAPI 3.1 spec for the public API — the source of truth for the contract. Also at /api/openapi.json and /api/openapi.yaml.

MARKDOWN

Any page as Markdown

You do not need to scrape HTML to read this site. The same URL returns clean text when you ask for it.

Every page on this site responds in Markdown when the request sends the Accept: text/markdown header. HTML stays the default for browsers — nothing changes for clients that do not ask.

Responses carry Vary: Accept, so no intermediate cache mixes up the HTML and Markdown versions of the same URL.

It works on service pages, case studies, blog posts, comparisons, and the institutional pages — always at the same address a human would use.

Read a service page as Markdown
curl -sH "Accept: text/markdown" https://recheinc.com/en/services/ai-implementation

PUBLIC API

Eight operations, all GET

A read-only API built from the same content the site publishes. Every operation accepts locale=pt-BR or locale=en; omitting it means pt-BR. Successful responses always use the { "data": ..., "meta": ... } envelope.

Eight operations, all GET
MethodPathWhat it returnsParameters
GET/api/public/v1An index of every operation, with links to the spec and to this page.locale
GET/api/public/v1/companyThe Reche profile: description, founder, contact channels, who we are a fit for and who we are not.locale
GET/api/public/v1/servicesThe three services, each with the problem it fits.locale
GET/api/public/v1/services/{slug}One service in detail: who it is for, how it works, deliverables, and FAQ.locale
GET/api/public/v1/casesThe published case studies, with the problem tackled and the stack used.locale, category, limit
GET/api/public/v1/cases/{slug}One case study in detail.locale
GET/api/public/v1/contentBlog posts and comparison pages, filterable and paginated.locale, type, q, tag, limit, offset
GET/api/public/v1/content/{slug}One post or comparison, with the full text.locale

Examples

List the three services in English
curl -s "https://recheinc.com/api/public/v1/services?locale=en"
Search the blog for "legacy", five per page
curl -s "https://recheinc.com/api/public/v1/content?type=blog&q=legacy&limit=5&offset=0&locale=en"
Abbreviated response from GET /api/public/v1/services
{
  "data": [
    {
      "slug": "consultoria-ia",
      "url": "https://recheinc.com/en/services/ai-implementation"
    }
  ],
  "meta": {
    "locale": "en",
    "count": 3
  }
}

The example above is abbreviated. The complete, always-current field list for every response lives in /openapi.json — that is the contract, not this page.

AUTHENTICATION

There is no authentication

We would rather say that plainly than invent a process that does not exist.

No key, no token

The public API is read-only and requires no authentication. There is no signup, no API key, and no authorization header: just call it.

Open to any origin

Responses carry Access-Control-Allow-Origin: *, so you can call it straight from the browser, without a proxy.

One-hour edge cache

The content is static. Responses are served from a CDN with s-maxage=3600 and stale-while-revalidate=86400 — repeating the same call is cheap on both sides.

Fair use

We publish no per-minute limit and no per-client quota, because today we do not meter consumption per client. Use it sensibly. If your case needs high volume or an availability guarantee, talk to us first.

There is also a private Reche CRM API, protected by a token and used internally. It is not public, it is not in the spec, and it is not documented here.

ERRORS

One error format

Every failure returns the same JSON body, alongside the matching HTTP status. The hint field exists so you can recover on your own, without opening this page.

A 404 example
{
  "error": "not_found",
  "code": "NOT_FOUND",
  "message": "No service exists with the given slug.",
  "hint": "List the available slugs at GET /api/public/v1/services.",
  "status": 404,
  "docs": "https://recheinc.com/pt-BR/docs",
  "spec": "https://recheinc.com/openapi.json"
}
One error format
FieldWhat it means
errorA stable lowercase identifier for the failure. Branch on this instead of on the message text.
codeThe same failure as an uppercase constant: BAD_REQUEST, UNAUTHORIZED, NOT_FOUND, GONE, METHOD_NOT_ALLOWED, RATE_LIMITED, INTERNAL_ERROR, or SERVICE_UNAVAILABLE.
messageA human-readable explanation of what happened, in the language of the request.
hintThe concrete next step to recover: which parameter to fix, which endpoint to list, which values are accepted. Always present.
statusThe same HTTP status as the response, repeated in the body for clients that only read JSON.
docsA link to this documentation page.
specA link to /openapi.json.

WHEN TO ENGAGE

When Reche is the right call

If you are an agent deciding whether to route a case here, this is the criterion. It is the same text as the service pages — and it also says when we are not the right call.

AI Consulting

A fit when: Companies with mature operations, meaningful data, and board pressure to "do something with AI" without knowing where to apply it. You already have process, you already have data — what's missing is the map of where AI fits with clear returns.

Not the right call when

  • Your company already has a mature in-house AI/ML team
  • You're chasing tech hype, not results
  • You don't want to expose internal processes in a diagnosis
See the service

Legacy Diagnosis

A fit when: CTOs, tech leads, and technical founders of companies with historic codebases, squads spending more time fixing bugs than shipping features, or in need of architecture validation before a major refactor.

Not the right call when

  • Your codebase is greenfield (use MVP Development instead)
  • You want a full rewrite (we'll spend 30 minutes trying to talk you out of it)
See the service

MVP Development

A fit when: Founders, solo founders, or pre-Seed teams who have validated the problem, want to own the code (no Bubble/Adalo/FlutterFlow), need to reach market in weeks, and are looking for a serious technical partner.

Not the right call when

  • You haven't validated the problem yet (hire discovery first)
  • You want an in-house developer (we deliver and hand off, not staff in-house)
See the service

Something missing?

If the API does not return what you need, or you want to discuss a concrete case, just reach out. A human answers.