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

# Visió general de l'API de Gorelo

> Integreu productes externs amb l'API de Gorelo mitjançant autenticació per clau API amb la capçalera X-API-Key, permisos d'àmbit i errors HTTP.

Gorelo us permet integrar-vos amb qualsevol producte extern mitjançant l'API de Gorelo.

L'API de Gorelo utilitza claus API. Incloeu la vostra clau a cada sol·licitud mitjançant la capçalera X-API-Key.

L'URL base de Gorelo depèn de la regió que hàgiu triat per allotjar les vostres dades a Gorelo:

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

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

## Àmbits i permisos

Les claus API es poden **limitar per àmbit**. Si una clau no té accés a un punt final, l'API retorna **403 Forbidden**.

## Gestió d'errors

| Error                     | Significat                          |
| :------------------------ | :---------------------------------- |
| **401 Unauthorized**      | Clau API absent o no vàlida         |
| **403 Forbidden**         | Clau vàlida, àmbit insuficient      |
| **429 Too Many Requests** | S'ha superat el límit de freqüència |

## IDs d'estat

## Actius dels agents

| ID | Estat                       |
| :- | :-------------------------- |
| 1  | Instal·lant                 |
| 2  | En línia                    |
| 3  | Fora de línia               |
| 4  | Supressió pendent           |
| 5  | Suprimit                    |
| 6  | Supressió de client pendent |
| 7  | Client suprimit             |