Menu

F&A Works · API

API e documentação para agentes

A F&A Works prepara a marca de startups antes do pitch. Esta página reúne o que um agente de IA ou um desenvolvedor precisa para consultar o estúdio de forma programática: serviços, cases e as páginas do site em Markdown.

Autenticação e formato

A API é pública e não exige autenticação nem chave. Todas as respostas são JSON, exceto a leitura em Markdown. Erros seguem sempre o mesmo formato, com um código estável, a mensagem e uma dica de resolução:

{
  "error": {
    "code": "invalid_request",
    "message": "Valor inválido em `service`: x.",
    "hint": "Use um destes valores: Identidade, Site, …",
    "status": 400,
    "docs": "https://www.fsza.works/openapi.json"
  }
}

Endpoints

  • GET /api/v1/services

    Catálogo de serviços: entregáveis, prazo típico e momento do ciclo de capital.

    operationId: listServices

  • GET /api/v1/cases

    Cases públicos, com setor e serviços entregues. Parâmetro opcional `service`.

    operationId: listCases

  • GET /api/v1/markdown?path=/…

    Qualquer página pública do site em Markdown.

    operationId: getPageMarkdown

  • POST /api/subscribe

    Inscreve um e-mail nas novidades, apenas com consentimento de quem é dono do e-mail. 5 chamadas por minuto por IP.

    operationId: subscribeToUpdates

Especificação completa (OpenAPI 3.1): /openapi.json.

Exemplos de requisição

Listar serviços

curl -s https://www.fsza.works/api/v1/services

Listar cases (filtro opcional)

curl -s "https://www.fsza.works/api/v1/cases?service=Identidade"

Ler uma página como Markdown

curl -s -H 'Accept: text/markdown' https://www.fsza.works/services

Mesma página pela API

curl -s "https://www.fsza.works/api/v1/markdown?path=/services"

Para agentes de IA

O resumo do estúdio, com a seção “quando usar a F&A Works”, está em /llms.txt. Qualquer página responde em Markdown quando a requisição traz Accept: text/markdown; endereços inexistentes respondem 404 também em Markdown, com links para o sitemap e o llms.txt. O design system do estúdio está documentado em /docs.

Contato

Dúvidas sobre a API ou sobre integração: felipe@fsza.works. Para conversar sobre um projeto de marca, use a página de contato.