Developers — ft.ia.br
Portal de desenvolvedores do ft.ia.br — blog de Fabricio Telles sobre tecnologia,
IA, FinOps e cibersegurança. Toda a superfície de leitura é pública, sem autenticação, com respostas
server-side renderizadas. Agentes IA devem começar por
/llms.txt ou pelo catálogo
/.well-known/ai-catalog.json.
Início rápido
Listar os artigos recentes e carregar contexto do autor:
# Contexto completo para LLMs
curl -s https://ft.ia.br/llms.txt
# Artigos via RSS
curl -s https://ft.ia.br/rss.xml
# Perfil estruturado
curl -s https://ft.ia.br/agent.json | jq '.name'Especificação OpenAPI
A superfície pública está documentada em
/openapi.json (OpenAPI 3.1) com operationIds únicos,
parâmetros tipados e modelo de erro estruturado — compatível com geração de clientes SDK e
function calling de LLMs.
Endpoints disponíveis
Contexto para LLMs
| Recurso | Descrição | URL | Formato |
|---|---|---|---|
llms.txt | Índice de contexto navegável | /llms.txt | text/plain |
llms-full.txt | Contexto completo com posts integrais | /llms-full.txt | text/plain |
agent.json | Perfil e conteúdo estruturado | /agent.json | application/json |
index.md | Homepage em markdown | /index.md | text/markdown |
Conteúdo
| Recurso | Descrição | URL | Formato |
|---|---|---|---|
rss.xml | Feed RSS dos artigos | /rss.xml | application/rss+xml |
sitemap-index.xml | Sitemap index | /sitemap-index.xml | application/xml |
Descoberta agent-ready (.well-known)
| Recurso | Descrição | URL | Formato |
|---|---|---|---|
ai-catalog.json | Catálogo ARD de recursos agênticos | /.well-known/ai-catalog.json | application/json |
agent-card.json | A2A Agent Card | /.well-known/agent-card.json | application/json |
mcp/server-card.json | MCP Server Card | /.well-known/mcp/server-card.json | application/json |
agent-skills/index.json | Índice de skills (v0.2.0) | /.well-known/agent-skills/index.json | application/json |
api-catalog | API Catalog (RFC 9727) | /.well-known/api-catalog | application/linkset+json |
oauth-protected-resource | OAuth Protected Resource (RFC 9728) | /.well-known/oauth-protected-resource | application/json |
oauth-authorization-server | Authorization Server Metadata (RFC 8414) | /.well-known/oauth-authorization-server | application/json |
security.txt | Contato de segurança (RFC 9116) | /.well-known/security.txt | text/plain |
Automação de agentes
| Recurso | Descrição | URL | Formato |
|---|---|---|---|
auth.md | Walkthrough de autenticação (auth.md v1) | /auth.md | text/markdown |
agent/auth | Registro anônimo de agente | /agent/auth | application/json |
agent/revoke | Revogação de credencial | /agent/revoke | application/json |
Escopos de acesso
Os metadados OAuth (RFC 8414) declaram os
escopos abaixo. Como todo o conteúdo é público, o fluxo anônimo concede
public, que engloba todas as permissões de leitura:
| Escopo | Descrição |
|---|---|
public | Leitura de todo o conteúdo público (default anônimo) |
read:profile | Perfil, certificações e trajetória |
read:posts | Artigos do blog e metadados |
read:context | Arquivos de contexto LLM (llms*.txt) |
Modelo de erros
Erros seguem o modelo documentado na OpenAPI spec (
Error): JSON estruturado com error.code,
error.message e error.hint. Recursos inexistentes retornam HTTP 404
real (nunca 200 com página de aplicativo).
Sandbox
Todo o ambiente é somente leitura e público — não existe separação entre produção e sandbox porque nenhuma operação de escrita é exposta. Agentes podem exercer qualquer endpoint sem risco.
Skills para agentes
Três skills instaláveis via índice
/.well-known/agent-skills/index.json:
ft-ia-br-context (contexto do site),
llms-context (perfil do autor) e
read-blog-posts (leitura de artigos).
Contato
Dúvidas sobre integração: página de contato · Relatórios de segurança: security.txt