---
title: "lobo — Portal de Desenvolvedores & Referência de API (lobo.sh)"
description: "Interfaces legíveis por máquina, referência da API REST, especificações OpenAPI 3.1.0, comandos curl rápidos e diretrizes para agentes de IA no lobo.sh."
canonical: "https://lobo.sh/pt/developers"
lang: "pt"
---

# lobo.sh Portal de Desenvolvedores & Referência de 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.

## lobo.sh Especificações Principais
- **Especificação OpenAPI 3.1.0 (JSON):** https://lobo.sh/openapi.json
- **Especificação OpenAPI (YAML):** https://lobo.sh/api/openapi.yaml
- **Manifesto de Contexto LLM:** https://lobo.sh/llms.txt
- **Contexto Técnico Completo:** https://lobo.sh/llms-full.txt
- **Diretrizes para Agentes:** https://lobo.sh/agent-instructions.md

## lobo.sh Início Rápido da API (curl)
```bash
# 1. Integridade operacional, versão e cabeçalhos
curl -s -i https://lobo.sh/api/v1/health

# 2. Perfil do autor e links verificados
curl -s https://lobo.sh/api/v1/profile

# 3. Listagem de ensaios técnicos
curl -s https://lobo.sh/api/v1/essays

# 4. Conteúdo completo de um ensaio por slug
curl -s https://lobo.sh/api/v1/essays/architecture-decisions

# 5. Busca no catálogo do site
curl -s https://lobo.sh/api/v1/search

# 6. Negociação de conteúdo Markdown
curl -s -H "Accept: text/markdown" https://lobo.sh/pt
```

## lobo.sh Política de Autenticação & Limites da API
- **Acesso Público de Leitura:** Todos os endpoints são públicos; não é necessária chave de API.
- **CORS:** Habilitado globalmente (`Access-Control-Allow-Origin: *`).
- **Limite Sugerido:** 60 requisições por minuto por IP.
- **Cabeçalhos RFC RateLimit:** Respostas incluem:
  - `RateLimit-Limit: 60`
  - `RateLimit-Remaining: 59`
  - `RateLimit-Reset: 60`
  - `RateLimit-Policy: 60;w=60`
- **Recuperação de Limite:** Status HTTP 429 com cabeçalho `Retry-After: <segundos>`.
- **Tratamento de Erros:** JSON estruturado (`code`, `message`, `resolution_hint`) em status 4xx/5xx.

## lobo.sh Versionamento da API & Política de Descontinuação
- **Versionamento na URL:** Versão ativa `v1` (`/api/v1/...`).
- **Cabeçalhos de Versão:** Emite `API-Version: 1.0.0` e `X-API-Version: 1.0.0`.
- **Sinalização de Descontinuação:** Emite RFC 9594 `Deprecation: @<timestamp>` e RFC 8594 `Sunset: <HTTP-date>`.
- **Janela de Descontinuação:** Garantia mínima de suporte por **12 meses** antes da remoção do endpoint.

## lobo.sh Negociação de Conteúdo Markdown (acceptmarkdown.com)
Toda rota em HTML pode retornar Markdown puro com o cabeçalho:
`Accept: text/markdown`

Endpoints diretos em Markdown:
- https://lobo.sh/pt/index.md
- https://lobo.sh/pt/about.md
- https://lobo.sh/pt/contact.md
- https://lobo.sh/pt/privacy.md
- https://lobo.sh/pt/developers.md
- https://lobo.sh/pt/essays/architecture-decisions.md