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

# Introdução da API

> Base URL, formato de requisição, paginação e erros.

## Base URL

| Ambiente                    | Base URL                                  |
| --------------------------- | ----------------------------------------- |
| Alforse Cloud               | `https://api.alforse.com/api/v1`          |
| Auto-hospedagem empresarial | `https://api.your-company.example/api/v1` |

## Escopo do tenant

Cada token de tenant contém tenantId, roleCode e subjectScope. Escopo incompatível pode ocultar recursos com 404.

## Formato da requisição

* Content-Type: application/json
* Campos desconhecidos são rejeitados pela validação DTO.
* Endpoints de lista usam page e pageSize; pageSize máximo é 200.

## Erros e códigos

Uso primeiro o status HTTP e depois `error.code` quando existir. Veja [Erros e códigos](/pt/api-reference/errors).