# Nebular Docs

A Nebular é uma plataforma de hospedagem. Esta documentação é escrita para **pessoas e para agents de IA**: cada página existe também em Markdown cru (acrescente `.md` à URL) e todo o conteúdo está em texto puro em [`/llms-full.txt`](/llms-full.txt).

## Usar com um agent

1. Crie um [token de API](/comecar/token/) (`nbk_…`).
2. Cole no agent o conteúdo de `https://docs.nebularws.com/llms-full.txt` (ou aponte para `https://docs.nebularws.com/llms.txt`) e o token como segredo do ambiente, nunca no texto do prompt.
3. Peça a tarefa. Veja [Como um agent usa isto](/comecar/como-um-agent-usa-isto/) e [Para agents](/agents/).

## O que a API cobre

A API pública `/v1` cobre **projetos, serviços, deploys, variáveis com referência, rede privada, volumes, bancos, domínios, templates (WordPress), galerias e arquivos**. Os guias descrevem o contrato v13; páginas ainda marcadas “em construção” (referência gerada de rotas, isolamento) não têm API publicada: não invente rotas.

## Mapa

| Área | Conteúdo | Estado |
|---|---|---|
| [Começar](/comecar/token/) | token, conceitos, convenções da API | real |
| [CDN e imagens](/cdn/visao-geral/) | galerias, arquivos, transformação, cache | real |
| [Erros](/erros/tabela/) | código, HTTP, causa e ação do agent | real |
| [Segurança](/seguranca/tokens-e-escopos/) | tokens, escopos, abuso | parcial |
| [Operação](/operacao/limites-e-cotas/) | limites e cotas, [como escrever um app pronto para escalar](/operacao/app-pronto-para-escalar/) | parcial |
| [Referência da API](/referencia/autenticacao/) | gerada da OpenAPI | parcial |
| [Guias por stack](/guia/go/), [bancos](/bancos/postgres/), [domínios](/dominios/dominio-proprio/), [receitas](/receitas/do-zero-ao-ar-com-um-agent/) | deploy ponta a ponta | real (contrato v13) |