> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API pública da Hybridbox

> Use a API pública da Hybridbox para gerenciar contas, domínios, caixas de correio, registros DNS, regras de encaminhamento, senhas mestras, tags, espaços de trabalho e IPs dedicados.

# API pública da Hybridbox

## Autenticação

A API REST usa tokens de acesso bearer OAuth 2.0.

Para obter um token em integrações de navegador ou aplicativo web:

1. Inicie o fluxo OAuth padrão de código de autorização com o cliente público do aplicativo web Hybridbox.
2. Envie o usuário ao endpoint de autorização da Hybridbox e solicite os escopos OpenID usuais.
3. Depois que o usuário entrar, troque o código de autorização retornado por tokens no endpoint de token da Hybridbox. Clientes públicos de navegador devem usar PKCE; aplicativos web do lado do servidor devem fazer a troca no backend.
4. Leia `access_token` na resposta de tokens.

Use o token de acesso em requisições REST API autenticadas:

```http theme={null}
Authorization: Bearer <access_token>
```

A API valida o emissor do token e exige um ID de cliente público permitido, incluindo o cliente do aplicativo web Hybridbox. As páginas de endpoints listam qualquer permissão adicional necessária para o usuário ou grupo autenticado.

## Especificação OpenAPI

Baixe o contrato completo da API pública como [openapi.json](/openapi.json).