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

# Aperçu de l'API Gorelo

> Intégrez des produits externes via l'API Gorelo avec l'authentification par clé API dans l'en-tête X-API-Key, les portées et la gestion des erreurs HTTP.

Gorelo vous permet de vous intégrer à n'importe quel produit externe grâce à l'API Gorelo.

L'API Gorelo utilise des clés API. Incluez votre clé dans chaque requête via l'en-tête X-API-Key.

L'URL de base de Gorelo dépend de la région que vous avez choisie pour héberger vos données dans Gorelo :

<Tabs>
  <Tab title="US">
    URL de base : [**https://api.usw.gorelo.io/**](https://api.usw.gorelo.io/)\
    Référence de l'API : [**https://api.usw.gorelo.io/swagger**](https://api.usw.gorelo.io/swagger)
  </Tab>

  <Tab title="Australia">
    URL de base : [**https://api.aue.gorelo.io/**](https://api.aue.gorelo.io/)\
    Référence de l'API : [**https://api.aue.gorelo.io/swagger**](https://api.aue.gorelo.io/swagger)
  </Tab>
</Tabs>

## Portées et permissions

Vous pouvez limiter les clés API par **portée**. Si une clé n'a pas accès à un point d'extrémité, l'API renvoie **403 Forbidden**.

## Gestion des erreurs

| Erreur                    | Signification                   |
| :------------------------ | :------------------------------ |
| **401 Unauthorized**      | Clé API manquante ou invalide   |
| **403 Forbidden**         | Clé valide, portée insuffisante |
| **429 Too Many Requests** | Limite de débit dépassée        |

## Identifiants d'état

## Actifs d'agent

| ID | État                             |
| :- | :------------------------------- |
| 1  | Installation                     |
| 2  | En ligne                         |
| 3  | Hors ligne                       |
| 4  | Suppression en attente           |
| 5  | Supprimé                         |
| 6  | Suppression de client en attente |
| 7  | Client supprimé                  |