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

# API da Airbee

> Integre sistemas próprios à Airbee por meio de uma API REST.

A API da Airbee permite conectar sistemas próprios à operação de hospedagem. Cada recurso publicado nesta referência possui um contrato versionado, exemplos de requisição e respostas previsíveis.

<Note>
  A referência da API v1 está sendo publicada por etapas. Use somente as operações que aparecem nesta documentação.
</Note>

## URL base

Todas as operações da primeira versão usam a mesma URL base:

```text theme={null}
https://api.airbee.com.br/v1
```

As requisições e respostas usam JSON, salvo quando uma operação documentar outro formato.

## Como começar

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/referencia-api/autenticacao">
    Crie uma chave e envie-a com segurança em cada requisição.
  </Card>

  <Card title="Referência de recursos" icon="book-open">
    Consulte os endpoints disponíveis, seus campos e exemplos à medida que forem publicados.
  </Card>
</CardGroup>

## Princípios do contrato

* A versão faz parte da URL para que mudanças futuras possam ser introduzidas sem alterar integrações existentes.
* A chave de API identifica automaticamente a conta da Airbee. Não envie um identificador de conta para definir o escopo da requisição.
* Identificadores, estados e erros documentados pertencem ao domínio público da Airbee.
* Campos não documentados não fazem parte do contrato público e não devem ser usados por integrações.

## Próximos recursos

A referência será ampliada gradualmente com operações para hóspedes, acomodações, depoimentos e reservas. Cada conjunto será publicado somente depois que seus campos, respostas, erros e regras de exclusão estiverem definidos.