A1 Lab API docs

A A1 Lab (a1lab.com.br) publica um endpoint de contato para agentes e para o formulário do site. Não há API de produto, autenticação por token, nem MCP.

Quando usar

Use este endpoint para enviar um processo ou uma ideia para a A1 Lab. Para o trabalho em si, leia llms.txt.

Autenticação

Não há API key. Posts pelo formulário do site precisam do token Cloudflare Turnstile. Agentes que não conseguem completar o captcha devem escrever para contato@a1lab.com.br.

Versionamento e depreciação

A API pública atual é v1. O caminho canônico é POST /v1/contact. POST /api/contact é um alias estável usado pelo formulário do site.

Mudanças incompatíveis saem em /v2/. Enquanto v1 existir, respostas incluem o header API-Version: 1. Se uma versão for descontinuada, as respostas passam a incluir Deprecation: true e Sunset (HTTP-date), com pelo menos 90 dias de aviso antes da remoção.

Rate limits

O limite é 30 pedidos por hora por endereço IP. Toda resposta da API inclui os headers RFC RateLimit, RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Um 429 inclui Retry-After em segundos.

OpenAPI

• JSON: https://a1lab.com.br/openapi.json
• YAML: https://a1lab.com.br/api/openapi.yaml

Endpoint

POST https://a1lab.com.br/v1/contact (canônico) ou POST https://a1lab.com.br/api/contact

Content-Type: application/json

{
  "name": "Ana Silva",
  "email": "ana@empresa.com",
  "company": "Empresa",
  "subject": "Tenho uma ideia para testar",
  "stage": "Ideia inicial",
  "message": "Queremos testar extração de PDFs de contratos."
}

Resposta de sucesso: { "ok": true }.

Erros vêm em JSON com code, message e hint. GET em /v1/contact ou /api/contact devolve 405 com o mesmo formato.