lobo.sh
Interfaces de Máquina & Desenvolvedores

lobo.sh Portal de Desenvolvedores & API

O lobo.sh fornece interfaces programáticas de primeira classe, projetadas para engenheiros de software, execução automatizada de ferramentas e agentes autônomos de IA.

Especificação OpenAPI 3.1.0 (JSON)
/openapi.json →
Especificação OpenAPI (YAML)
/api/openapi.yaml →
Diretrizes para Agentes
/agent-instructions.md →
Manifesto de Contexto LLM
/llms.txt →

lobo.sh Início Rápido da API (curl)

Teste os endpoints públicos diretamente pelo terminal ou script:

# Verificar integridade operacional e versão
curl -s -i https://lobo.sh/api/v1/health
# Obter perfil do autor e links
curl -s https://lobo.sh/api/v1/profile
# Consultar representação em Markdown
curl -s -H "Accept: text/markdown" https://lobo.sh/pt

lobo.sh Política de Autenticação & Limite de Requisições da API

  • Autenticação: Todos os endpoints de leitura são públicos. Não são necessários tokens Bearer ou cadastro prévio.
  • CORS: Habilitado globalmente (Access-Control-Allow-Origin: *) em todas as rotas de API para execução no navegador e sandboxes de agentes.
  • Controle de Taxa: Limite de cortesia sugerido de 60 requisições por minuto por IP.
  • Cabeçalhos RFC RateLimit: As respostas incluem metadados de limite em tempo real:
    • RateLimit-Limit: 60 — Cota total por janela de 1 minuto
    • RateLimit-Remaining: 59 — Requisições restantes na janela ativa
    • RateLimit-Reset: 60 — Segundos para renovação da cota
    • RateLimit-Policy: 60;w=60 — Especificação da janela
  • Recuperação de Limite (HTTP 429): Se a cota for excedida, o servidor retorna status HTTP 429 com cabeçalho Retry-After informando os segundos necessários de espera.
  • Tratamento de Erros: Requisições inválidas retornam JSON estruturado com códigos legíveis por máquina e dicas de resolução (status 4xx/5xx).

lobo.sh Versionamento da API & Política de Descontinuação

O lobo.sh adota contratos estritos de estabilidade para que integrações e agentes autônomos operem com segurança previsível:

  • Versionamento na URL: As rotas são versionadas explicitamente no caminho (ex.: /api/v1/...). Versão ativa: v1.
  • Cabeçalhos de Versão: Cada resposta da API emite API-Version: 1.0.0 e X-API-Version: 1.0.0.
  • Sinalização de Descontinuação: Endpoints marcados para desativação emitem os cabeçalhos padrão IETF:
    • Deprecation: @<timestamp> (RFC 9594) — Data formal de descontinuação
    • Sunset: <HTTP-date> (RFC 8594) — Prazo final de encerramento
  • Janela de Migração de 12 Meses: Qualquer recurso descontinuado possui garantia mínima de suporte por 12 meses antes da remoção definitiva.

lobo.sh Catálogo da API REST Pública & Endpoints

GET /api/v1/health

Verificação de integridade operacional, versão da API, status de descontinuação e endpoints disponíveis.

curl -s https://lobo.sh/api/v1/health
GET /api/v1/profile

Perfil do autor, áreas de foco de engenharia e canais de contato verificados.

curl -s https://lobo.sh/api/v1/profile
GET /api/v1/essays

Lista de ensaios técnicos publicados com resumos, slugs e idiomas.

curl -s https://lobo.sh/api/v1/essays
GET /api/v1/essays/{slug}

Conteúdo completo, metadados e links canônicos de um ensaio por slug.

curl -s https://lobo.sh/api/v1/essays/architecture-decisions
GET /api/v1/search

Busca no catálogo do site, ensaios e princípios de arquitetura.

curl -s https://lobo.sh/api/v1/search

lobo.sh Negociação de Conteúdo Markdown (acceptmarkdown.com)

Toda página em lobo.sh disponibiliza versão em Markdown. Agentes de IA podem solicitar Markdown bruto enviando: 

Accept: text/markdown

Ou acessando os endpoints diretos com sufixo .md:

← Voltar ao início ver markdown bruto