> ## 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.

# Introduction API

> Base URL, format de requête, pagination et conventions d’erreur.

## Base URL

| Environnement               | Base URL                                  |
| --------------------------- | ----------------------------------------- |
| Alforse Cloud               | `https://api.alforse.com/api/v1`          |
| Auto-hébergement entreprise | `https://api.your-company.example/api/v1` |

## Périmètre locataire

Chaque jeton locataire porte tenantId, roleCode et subjectScope. Un périmètre non correspondant peut masquer une ressource en 404.

## Format de requête

* Content-Type: application/json
* Les champs inconnus sont rejetés par la validation DTO.
* Les endpoints de liste utilisent page et pageSize ; pageSize vaut au maximum 200.

## Erreurs et codes

Utilisez d’abord le statut HTTP, puis `error.code` s’il existe. Voir [Erreurs et codes](/fr/api-reference/errors).