> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/pour-les-hotes/api.md).

# API

> 💡 **Développeurs Python :** Utilisez le [SDK Python officiel clore-ai](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/developpeurs/python-sdk.md) à la place des appels API bruts. Il gère automatiquement l'authentification, la limitation du débit, les nouvelles tentatives et la gestion des erreurs.
>
> **Démarrage rapide :** `pip install clore-ai` — Voir la [documentation du SDK Python](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/developpeurs/python-sdk.md) et [Référence CLI](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/developpeurs/cli-guide.md).

> 🧭 Vous préférez une référence consultable ? Ouvrez la documentation interactive de l'API sur [clore.ai/api-docs](https://clore.ai/api-docs). URL de base pour tous les points de terminaison sur cette page : `https://api.clore.ai/v1/`.

<div data-full-width="true"><figure><img src="https://259039044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyNlC5NV8aIpXnc76G7w%2Fuploads%2FoEhopGeayaKnbuDjgTEs%2FCLORE%20Docs%20API%20Page.png?alt=media&amp;token=a0adf6bb-1fde-4f1b-8236-dff2563ffbfd" alt=""><figcaption></figcaption></figure></div>

### Introduction <a href="#introduction" id="introduction"></a>

[CLORE.AI](http://clore.ai/) l'API peut être utilisée pour automatiser les déploiements de vos charges de travail sur [CLORE.AI](http://clore.ai/)

Tout d'abord, vous devez obtenir une clé API\
![alt text](https://clore.ai/assets/html/api-export1.png)\
![alt text](https://clore.ai/assets/html/api-export2.png)

***

### Réponses de l'API <a href="#api-responses" id="api-responses"></a>

Les réponses sont renvoyées au format JSON et peuvent avoir différents champs

Le champ toujours renvoyé est code, indiquant l'état

**champ code**

| code | Description                          |
| ---- | ------------------------------------ |
| `0`  | NORMAL                               |
| `1`  | ERREUR DE BASE DE DONNÉES            |
| `2`  | DONNÉES D'ENTRÉE INVALIDES           |
| `3`  | JETON D'API INVALIDE                 |
| `4`  | POINT DE TERMINAISON INVALIDE        |
| `5`  | Limite de 1 requête/seconde dépassée |
| `6`  | Erreur spécifiée dans `erreur` champ |

***

### Points de terminaison <a href="#endpoints" id="endpoints"></a>

#### 1. `wallets` <a href="#id-1-wallets" id="id-1-wallets"></a>

**À propos**

Renvoie les portefeuilles et les soldes

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Sortie**

| Champ     | Type       | Description              |
| --------- | ---------- | ------------------------ |
| `code`    | `int`      | Code d'état              |
| `wallets` | `[]chaîne` | Tableau de portefeuilles |

**Exemple**

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/wallets'
```

**Sortie :**

```
{
  "wallets": [
    {
      "name": "bitcoin",
      "deposit": "tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr",
      "balance": 0.00153176,
      "withdrawal_fee": 0.0001
    }
  ],
  "code": 0
}
```

#### 2. `my_servers` <a href="#id-2-my_servers" id="id-2-my_servers"></a>

**À propos**

Renvoie vos serveurs que vous fournissez à [clore.ai](http://clore.ai/) marché

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Sortie**

| Champ                                 | Type       | Description                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                                | `int`      | Code d'état                                                                                                                                                                                                                                                                                                                             |
| `limite`                              | `int`      | Nombre maximum de serveurs que vous pouvez posséder                                                                                                                                                                                                                                                                                     |
| `servers`                             | `[]chaîne` | Tableau de serveurs                                                                                                                                                                                                                                                                                                                     |
| `servers[x].name`                     | `chaîne`   | Nom du serveur sélectionné par l'utilisateur                                                                                                                                                                                                                                                                                            |
| `servers[x].connected`                | `chaîne`   | Le serveur a-t-il déjà été connecté [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                                                        |
| `servers[x].visibility`               | `chaîne`   | Visibilité sur la marketplace                                                                                                                                                                                                                                                                                                           |
| `servers[x].pricing`                  | `[]chaîne` | Prix/jour à la demande                                                                                                                                                                                                                                                                                                                  |
| `servers[x].online`                   | `bool`     | Le serveur est-il en ligne                                                                                                                                                                                                                                                                                                              |
| `servers[x].min_spot_pricing`         | `[]chaîne` | Prix minimum/jour pour louer sur le marché spot                                                                                                                                                                                                                                                                                         |
| `servers[x].auto_renew_allowed`       | `bool`     | Indique si les commandes à la demande des locataires sur ce serveur peuvent être renouvelées à votre prix actuel lorsqu'elles atteignent la durée maximale de location. `true` lorsque vous ne l'avez jamais défini. Absent sur un serveur en cours de suppression. Modifiez-le avec [`set_server_settings`](#id-7-set_server_settings) |
| `servers[x].init_token`               | `chaîne`   | Jeton d'enregistrement de machine, renvoyé uniquement jusqu'à ce que la machine soit initialisée — **à considérer comme un identifiant d'accès**, il enregistre les machines sur votre compte                                                                                                                                           |
| `servers[x].specs`                    | `[]chaîne` | Spécifications du serveur                                                                                                                                                                                                                                                                                                               |
| `servers[x].remaining_time`           | `int`      | Heure de fin de location de la dernière commande active (epoch en ms)                                                                                                                                                                                                                                                                   |
| `servers[x].rental_state`             | `chaîne`   | État agrégé de location des GPU : `aucun`, `partiel`, ou `complet`                                                                                                                                                                                                                                                                      |
| `servers[x].rented_gpus`              | `int`      | GPU actuellement loués dans les commandes actives                                                                                                                                                                                                                                                                                       |
| `servers[x].total_gpus`               | `int`      | Nombre total de GPU sur le serveur                                                                                                                                                                                                                                                                                                      |
| `servers[x].rented_price_by_currency` | `objet`    | Somme des prix des commandes actives indexée par devise                                                                                                                                                                                                                                                                                 |
| `servers[x].update_channel`           | `chaîne`   | Canal de mise à jour de l'agent d'hébergement : `stable` ou `bêta`                                                                                                                                                                                                                                                                      |
| `servers[x].requested_channel`        | `chaîne`   | Changement de canal demandé depuis l'interface web (présent uniquement lorsqu'il est demandé)                                                                                                                                                                                                                                           |
| `servers[x].target_backend_version`   | `int`      | Version du backend visée par le canal actuel                                                                                                                                                                                                                                                                                            |

> Les champs d'état de location (`remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`) ne sont présents que lorsque le serveur a une commande active.

**Exemple**

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_servers'
```

**Sortie :**

```
{
  "servers": [
    {
      "name": "Michael",
      "connected": false,
      "visibility": "hidden",
      "pricing": { "bitcoin": 0, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0, "usd": 0 },
      "auto_renew_allowed": true,
      "init_token": "qnwVIMsZPjUWS7jw6gAbTOeoGQNgTH9XVxJaiCEbG0OlmfjF"
    },
    {
      "name": "Jan Vykydal",
      "connected": true,
      "visibility": "public",
      "pricing": { "bitcoin": 0.00010337, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "Intel Core i9-11900",
        "cpus": "8/16",
        "ram": 64,
        "disk": "NVMe 512GB",
        "disk_speed": 2000,
        "gpu": "1x GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "down":119.61,
          "up":25.24
        }
      }
    }
  ],
  "limit": 16,
  "code": 0
}
```

Les valeurs en USD dans `pricing` les objets reflètent le mode de tarification basé sur l'USD lorsque l'hôte l'a activé.

#### 3. `server_config` <a href="#id-3-server_config" id="id-3-server_config"></a>

**À propos**

Obtenir la configuration d'un serveur spécifique

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ         | Type     | Obligatoire | Description    |
| ------------- | -------- | ----------- | -------------- |
| `server_name` | `chaîne` | Oui         | Nom du serveur |

**Sortie**

| Champ                       | Type                | Description                                                                                                                                                                                 |
| --------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                      | `int`               | Code d'état                                                                                                                                                                                 |
| `creation_completed`        | `bool`              | La création du serveur est-elle terminée                                                                                                                                                    |
| `config`                    | `[]chaîne`          | Configuration du serveur                                                                                                                                                                    |
| `config.name`               | `chaîne`            | Nom du serveur sélectionné par l'utilisateur                                                                                                                                                |
| `config.connected`          | `bool`              | Le serveur a-t-il déjà été connecté [clore.ai](http://clore.ai/)                                                                                                                            |
| `config.visibility`         | `chaîne`            | Visibilité sur la marketplace                                                                                                                                                               |
| `config.pricing`            | `[]chaîne`          | Prix/jour à la demande                                                                                                                                                                      |
| `config.spot_pricing`       | `[]chaîne`          | Prix minimum/jour pour louer sur le marché spot                                                                                                                                             |
| `config.mrl`                | `int`               | Durée maximale de location en heures                                                                                                                                                        |
| `config.auto_renew_allowed` | `bool`              | Indique si les commandes à la demande des locataires sur ce serveur peuvent être renouvelées à votre prix actuel lorsqu'elles atteignent `mrl`. `true` lorsque vous ne l'avez jamais défini |
| `config.online`             | `bool`              | Le serveur est-il en ligne                                                                                                                                                                  |
| `config.initialized`        | `bool`              | Le serveur a-t-il déjà été connecté [clore.ai](http://clore.ai/)                                                                                                                            |
| `config.id`                 | `int`               | ID unique du serveur                                                                                                                                                                        |
| `config.rental_status`      | `int`               | 0 - non loué \| 1 - Loué sur le marché spot \| 2 - Loué à la demande \| 3 - location en USD fixe                                                                                            |
| `config.specs`              | `[]chaîne`          | Spécifications du serveur                                                                                                                                                                   |
| `config.background_job`     | `objet`             | Tâche d'arrière-plan lorsque non loué : `image`, `command`, `env`, `times_updated`                                                                                                          |
| `config.autoprice`          | `objet` \| `chaîne` | Configuration de tarification automatique par devise (des valeurs de chaîne héritées `"pow"` / `"usd"` sont également possibles)                                                            |
| `config.usd_pricing`        | `objet`             | Cibles de prix en USD — présentes uniquement lorsque la tarification automatique en USD est activée                                                                                         |
| `config.tenants`            | `[]objet`           | Commandes actives sur le serveur : `rental_type`, `currency`, `prix`, `remaining_time`, `gpu_count`                                                                                         |

> `server_config` renvoie également les mêmes champs d'état de location et de canal de mise à jour que `my_servers`: `remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`, `update_channel`, `requested_channel`, `target_backend_version`. Dans les deux points de terminaison, les champs d'état de location ne sont présents que lorsque le serveur a une commande active.

**Exemple**

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "server_name":"Jan Vykydal"
}' 'https://api.clore.ai/v1/server_config'
```

**Sortie :**

```
{
  "config": {
    "name": "Jan Vykydal",
    "connected": true,
    "visibility": "public",
    "pricing": { "bitcoin": 0.00010337, "usd": 0 },
    "spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
    "mrl": 72,
    "auto_renew_allowed": true,
    "online": false,
    "initialized": true,
    "id": 4,
    "rental_status": 0,
    "specs": {
      "mb": "Z590 GAMING X",
      "cpu": "Intel Core i9-11900",
      "cpus": "8/16",
      "ram": 64,
      "disk": "NVMe 512GB",
      "disk_speed": 2000,
      "gpu": "1x GeForce GTX 1080 Ti",
      "gpuram": 11,
      "net": {
        "down":119.61,
        "up":25.24
      }
    },
    "background_job": {
      "times_updated": 1,
      "image": "cloreai/ubuntu20.04-jupyter",
      "command": "",
      "env": []
    }
  },
  "creation_completed": true,
  "code": 0
}
```

Les valeurs en USD dans `pricing` les objets reflètent le mode de tarification basé sur l'USD lorsque l'hôte l'a activé.

#### 4. `marché` <a href="#id-4-marketplace" id="id-4-marketplace"></a>

**À propos**

Obtenir la marketplace

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Sortie**

| Champ                           | Type              | Description                                                                                                                                                                                                                                                         |
| ------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                          | `int`             | Code d'état                                                                                                                                                                                                                                                         |
| `my_servers`                    | `[]chaîne`        | Tableau d'identifiants de serveur que vous fournissez à [clore.ai](http://clore.ai/) (ne peut pas être loué)                                                                                                                                                        |
| `servers`                       | `[]chaîne`        | Tableau de serveurs publics sur la marketplace                                                                                                                                                                                                                      |
| `servers[x].id`                 | `int`             | ID unique du serveur                                                                                                                                                                                                                                                |
| `servers[x].owner`              | `int`             | Identifiant unique du propriétaire                                                                                                                                                                                                                                  |
| `servers[x].mrl`                | `int`             | Durée maximale de location en heures. Lorsque le serveur autorise le renouvellement automatique, c'est aussi la période de re-tarification : une commande renouvelée reprend le prix actuel de l'hôte à chaque fois qu'elle atteint cette durée                     |
| `servers[x].auto_renew_allowed` | `bool`            | Indique si l'hôte autorise le renouvellement automatique sur ce serveur. `true` lorsque l'hôte ne l'a jamais défini. Lorsque `false`, `create_order` avec `auto_renew: true` est refusé avec `auto_renew_not_allowed`, et `rental_hours` ne peut pas dépasser `mrl` |
| `servers[x].price.on_demand`    | `[]chaîne`        | Prix par jour à la demande                                                                                                                                                                                                                                          |
| `servers[x].price.spot`         | `[]chaîne`        | Prix minimum journalier sur le marché spot                                                                                                                                                                                                                          |
| `servers[x].rented`             | `bool`            | Le serveur est-il loué à la demande                                                                                                                                                                                                                                 |
| `servers[x].specs`              | `[]chaîne`        | Spécifications du serveur                                                                                                                                                                                                                                           |
| `servers[x].partial_gpu_rental` | `objet` \| `bool` | `false` lorsque la location partielle n'est pas disponible, sinon `{ total_gpus, available_gpus, free_indices }`                                                                                                                                                    |

> `price.on_demand` et `price.spot` n'incluez que les devises réellement acceptées par chaque serveur — un serveur sans prix dans une devise donnée ne peut pas être loué dans celle-ci.
>
> L'annonce est un instantané mis en cache, donc une modification de `mrl` ou `auto_renew_allowed` peut prendre quelques minutes avant d'apparaître ici.

**Exemple**

Obtenir la marketplace

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/marketplace'
```

**Sortie :**

```
{
  "servers": [
    {
      "id": 6,
      "owner": 4,
      "mrl": 73,
      "price": { "on_demand": { "bitcoin": 0.00001 },
      "spot": { "bitcoin": 0.000001 }},
      "rented": false,
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 0,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
          "cc": "CZ"
        }
      }
    }
  ],
  "my_servers": [1, 2, 4],
  "code": 0
}
```

#### 5. `my_orders` <a href="#id-5-my_orders" id="id-5-my_orders"></a>

**À propos**

Obtenir vos commandes

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Chaîne de requête**

| Champ              | Type   | Obligatoire | Description                                 |
| ------------------ | ------ | ----------- | ------------------------------------------- |
| `return_completed` | `bool` | Non         | Renvoyer les commandes terminées (expirées) |

**Sortie**

| Champ                            | Type       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                           | `int`      | Code d'état                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `limite`                         | `int`      | Actuellement toujours 999999                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders`                         | `[]chaîne` | Tableau de commandes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].id`                   | `int`      | ID unique de la commande                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].creation_fee`         | `float`    | Frais de création versés à [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].price`                | `float`    | Prix de la commande (coût) par jour                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].mrl`                  | `int`      | Secondes entre la création et la fin du terme actuel. Un renouvellement y ajoute le nouveau terme, donc `ct + mrl` est toujours la fin actuelle                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `orders[x].image`                | `chaîne`   | Image Docker utilisée                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].currency`             | `chaîne`   | Devise utilisée pour la facturation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].spend`                | `float`    | Montant réel débité jusqu'à présent : valeur de location cumulée plus les frais de base du locataire (après réduction PoH) et tout frais supplémentaire ; exclut les frais de création uniques                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].gpu_count`            | `int`      | Nombre de GPU occupés par la commande (commandes à la demande ; égal au total de GPU du rig, sauf s'il s'agit d'une location partielle)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].ct`                   | `int`      | Heure de création (heure UNIX)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].p`                    | `int`      | Cluster proxy actuellement utilisé                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `orders[x].specs`                | `[]chaîne` | Spécifications du serveur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `orders[x].si`                   | `int`      | ID unique du serveur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].pub_cluster`          | `[]chaîne` | Points de terminaison publics avec ports transférés                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].tcp_ports`            | `[]chaîne` | Transfert de ports TCP                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].http_port`            | `chaîne`   | Port du conteneur transféré via le proxy HTTPS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].spot`                 | `bool`     | Indication qu'il s'agit d'une commande spot                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].expired`              | `bool`     | Indication que la commande a expiré                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].rental_hours`         | `int`      | Heures demandées, comptées à partir de la création (uniquement à la demande). Absent lorsqu'aucune limite n'a été demandée : la commande se termine alors à la durée maximale de location de l'hôte, sauf si `auto_renew` est activé, auquel cas elle s'exécute jusqu'à votre annulation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].rental_end`           | `int`      | Heure UNIX à laquelle les heures demandées sont épuisées ; absent lorsqu'aucune limite n'a été demandée                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].term_start`           | `int`      | Heure UNIX à laquelle le terme actuel a commencé (création ou dernier renouvellement)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].term_end`             | `int`      | Heure UNIX à laquelle le terme actuel se termine ; toujours `ct + mrl`. Absent sur les commandes spot et sur une commande à la demande créée avant l'arrivée du renouvellement automatique et jamais modifiée depuis                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].term_mrl`             | `int`      | Durée maximale de location de l'hôte, en secondes, lorsque le terme actuel a commencé. [`set_order_auto_renew`](#id-16-set_order_auto_renew) peut prolonger le terme actuel jusqu'à `term_start + term_mrl`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].last_renewal_at`      | `int`      | Heure UNIX à laquelle le dernier renouvellement a été appliqué ; absent avant le premier renouvellement                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].auto_renew`           | `bool`     | Indique si la commande est renouvelée au prix actuel de l'hôte lorsque le terme actuel se termine. Défini sur `false` lorsqu'un renouvellement est refusé. Absent sur une commande créée sans renouvellement automatique et jamais modifiée                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].auto_renew_max_price` | `float`    | Votre limite de prix par jour pour les renouvellements, dans la devise de la commande. Un renouvellement est refusé lorsque le prix de l'hôte est supérieur à cette limite                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `orders[x].renewals_count`       | `int`      | Nombre de renouvellements appliqués jusqu'à présent ; absent avant le premier renouvellement                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].pending_renewal`      | `objet`    | Présent lorsqu'un renouvellement est programmé à la fin du terme actuel : `prix` (`float`, le prix par jour du prochain terme) et `term_seconds` (`int`, la durée du prochain terme en secondes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].auto_renew_declined`  | `objet`    | Présent après le refus d'un renouvellement : `raison` et `à` (heure UNIX de la décision). La commande se termine à la fin de sa période en cours. `raison` est l'un des `price_above_cap` (le nouveau prix journalier de l'hôte est supérieur à `auto_renew_max_price`), `server_unlisted` (le serveur est masqué ou en cours de suppression, n'accepte plus la devise de la commande ou n'en a plus de prix, ou ne passe plus les vérifications de santé qu'une nouvelle commande doit passer), `host_disallowed` (l'hôte a désactivé le renouvellement automatique), `server_reserved` (le serveur est réservé à un autre locataire) ou `insufficient_balance` (après paiement du temps jusqu'à la fin de la période, votre solde couvrirait moins d'une heure au nouveau prix) |

> Chaque commande à la demande créée depuis l'introduction du renouvellement automatique comporte `term_start`, `term_end` et `term_mrl`. Les autres champs de renouvellement n'apparaissent que lorsqu'ils s'appliquent : `rental_hours` et `rental_end` lorsque des heures ont été demandées, `auto_renew` et `auto_renew_max_price` lorsque le renouvellement automatique a été demandé à la création ou défini via [`set_order_auto_renew`](#id-16-set_order_auto_renew), et `renewals_count` et `last_renewal_at` après le premier renouvellement. Voir [Durée de location et renouvellement automatique](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/pour-les-locataires/order-management.md#rental-length-and-auto-renewal).

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_orders?return_completed=true'
```

La première commande ci-dessous est une commande à la demande sur un serveur avec une durée de location maximale de 73 heures (`mrl` soit 262800 secondes), créée avec `rental_hours: 120` et le renouvellement automatique activé, et elle est toujours dans sa première période. La seconde est une commande spot expirée.

**Sortie :**

```
{
  "orders": [
    {
      "id": 38,
      "creation_fee": 3e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 6.944444444444445e-9,
      "ct": 1667401396,
      "p": 1,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "pub_cluster": [ "n1.c1.clorecloud.net", "n2.c1.clorecloud.net" ],
      "tcp_ports": [ "22:10000" ],
      "http_port": "8888",
      "ssh_auth": "password",
      "rental_hours": 120,
      "rental_end": 1667833396,
      "term_start": 1667401396,
      "term_end": 1667664196,
      "term_mrl": 262800,
      "auto_renew_max_price": 0.0000125,
      "auto_renew": true
    },{
      "id": 36,
      "creation_fee": 1e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 1.3888888888888888e-7,
      "ct": 1667248597,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "spot": true,
      "ssh_auth": "password",
      "expired": true,
      "tcp_ports": []
    }
  ],
  "limit": 999999,
  "code": 0
}
```

#### 6. `spot_marketplace` <a href="#id-6-spot_marketplace" id="id-6-spot_marketplace"></a>

**À propos**

Obtenir la place de marché spot pour un serveur spécifique

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Chaîne de requête**

| Champ    | Type  | Obligatoire | Description          |
| -------- | ----- | ----------- | -------------------- |
| `market` | `int` | Oui         | ID unique du serveur |

**Sortie**

| Champ                          | Type      | Description                                                            |
| ------------------------------ | --------- | ---------------------------------------------------------------------- |
| `code`                         | `int`     | Code d'état                                                            |
| `existe`                       | `bool`    | Vérification que le marché existe                                      |
| `market`                       | `objet`   | Marché                                                                 |
| `market.offers`                | `tableau` | Offres de location pour le serveur                                     |
| `market.offers[x].offer_id`    | `int`     | ID unique de l'offre                                                   |
| `market.offers[x].bid`         | `float`   | Prix proposé par jour (dans la devise de l'offre)                      |
| `market.offers[x].currency`    | `chaîne`  | Devise de l'offre                                                      |
| `market.offers[x].active`      | `bool`    | Cette offre est actuellement utilisée                                  |
| `market.offers[x].my`          | `bool`    | Cette offre m'appartient                                               |
| `market.server`                | `objet`   | Informations sur le serveur                                            |
| `market.server.min_pricing`    | `objet`   | Prix minimum de l'offre par jour, pour chaque devise acceptée          |
| `market.server.mrl`            | `int`     | Durée maximale de location en **heures**                               |
| `market.server.visibility`     | `chaîne`  | Vous ne pouvez créer des offres que lorsque la visibilité est publique |
| `market.server.online`         | `bool`    | Le serveur est en ligne                                                |
| `market.currency_rates_in_usd` | `objet`   | Taux USD en temps réel utilisés pour comparer les offres entre devises |

> Les offres peuvent être placées dans n'importe quelle devise acceptée par le serveur ; les offres concurrentes sont comparées selon leur **valeur en USD** (en utilisant `currency_rates_in_usd`), et non la valeur nominale.
>
> ⚠️ **Modifié en août 2026 :** `market.server.mrl` est désormais renvoyé en **heures** (auparavant en secondes). Une valeur qui s'affichait `262800` s'affiche désormais `73`.

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/spot_marketplace?market=6'
```

**Sortie :**

```
{
  "market": {
    "offers": [
      {
        "offer_id": 39,
        "bid": 0.0000042,
        "active": true,
        "my": true,
        "currency": "bitcoin"
      }
    ],
    "server": {
      "min_pricing": {
        "bitcoin": 0.000001
      },
      "mrl": 73,
      "visibility": "public",
      "online": true
    },
    "currency_rates_in_usd": {
      "bitcoin": 110000,
      "CLORE-Blockchain": 0.0045,
      "USD-Blockchain": 1
    }
  },
  "exists": true,
  "code": 0
}
```

#### 7. `set_server_settings` <a href="#id-7-set_server_settings" id="id-7-set_server_settings"></a>

**À propos**

Configurer les paramètres du serveur que vous fournissez sur [clore.ai](http://clore.ai/) marché

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ                        | Type     | Obligatoire | Description                                                                                                                                                                                                                                                                                                                 |
| ---------------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                       | `chaîne` | Oui         | Nom du serveur sélectionné par l'utilisateur                                                                                                                                                                                                                                                                                |
| `availability`               | `bool`   | Oui         | Le serveur peut-il être loué                                                                                                                                                                                                                                                                                                |
| `mrl`                        | `int`    | Oui         | Durée maximale de location du serveur en **heures** (6 to 3000)                                                                                                                                                                                                                                                             |
| `bitcoin_on_demand`          | `float`  | Oui         | Prix à la demande en BTC par jour                                                                                                                                                                                                                                                                                           |
| `bitcoin_spot`               | `float`  | Oui         | Prix spot minimum en BTC par jour                                                                                                                                                                                                                                                                                           |
| `CLORE-Blockchain_on_demand` | `float`  | Non         | Prix à la demande en CLORE par jour                                                                                                                                                                                                                                                                                         |
| `CLORE-Blockchain_spot`      | `float`  | Non         | Prix spot minimum en CLORE par jour                                                                                                                                                                                                                                                                                         |
| `USD-Blockchain_on_demand`   | `float`  | Non         | Prix à la demande en USD par jour                                                                                                                                                                                                                                                                                           |
| `USD-Blockchain_spot`        | `float`  | Non         | Prix spot minimum en USD par jour                                                                                                                                                                                                                                                                                           |
| `enabled-bitcoin`            | `bool`   | Non\*       | Accepter Bitcoin pour ce serveur                                                                                                                                                                                                                                                                                            |
| `enabled-CLORE-Blockchain`   | `bool`   | Non\*       | Accepter CLORE pour ce serveur                                                                                                                                                                                                                                                                                              |
| `enabled-USD-Blockchain`     | `bool`   | Non\*       | Accepter les stablecoins USD pour ce serveur                                                                                                                                                                                                                                                                                |
| `autoprice`                  | `objet`  | Non         | Tarification automatique par devise : définissez une clé de devise (`bitcoin`, `CLORE-Blockchain`) à `"usd"` pour une tarification automatique basée sur l'USD ou `false` pour une tarification fixe                                                                                                                        |
| `usd_pricing`                | `objet`  | Non         | Objectifs de prix en USD par devise, par ex. `{ "bitcoin": { "on_demand": 10, "spot": 5 } }` — utilisé uniquement pour les devises avec `autoprice` défini sur `"usd"`                                                                                                                                                      |
| `auto_renew_allowed`         | `bool`   | Non         | Autoriser les commandes à la demande des locataires à se renouveler à votre prix actuel lorsqu'elles atteignent `mrl`. Omettez-le pour conserver le paramètre enregistré ; un serveur qui ne l'a jamais défini autorise les renouvellements. Une valeur autre que `true` ou `false` est refusée avec le code `2` (HTTP 400) |

> \* **La liste des devises acceptées est reconstruite à partir des `enabled-*` indicateurs à chaque appel.** Une devise sans son `enabled-<currency>: true` indicateur (ou sans prix valide) est retirée des devises acceptées du serveur — omettre tous les indicateurs laisse le serveur impossible à louer dans toute devise. Envoyez toujours `enabled-<currency>: true` pour chaque devise que vous souhaitez continuer à accepter.
>
> Les prix par jour sont plafonnés par devise : 0.000001–0.1 BTC, 0.1–5,000,000 CLORE, 0.1–10,000 USD.
>
> Lorsqu'une devise est tarifiée automatiquement en USD, son prix crypto affiché est dérivé de `usd_pricing` au taux de change en temps réel (recalculé environ toutes les 10 minutes) et toute `<currency>_on_demand` / `<currency>_spot` valeur envoyée pour celle-ci est ignorée. Les `usd_pricing` cibles sont des montants $/jour pour l'ensemble du serveur validés par rapport à la plage USD (0.1 à 10,000) ; les valeurs hors plage sont ramenées à la borne la plus proche.
>
> Avec `auto_renew_allowed` activé (par défaut), `mrl` c'est aussi votre période de revalorisation : une commande dont le locataire a choisi le renouvellement automatique se renouvelle chaque fois qu'elle atteint `mrl`, à votre prix à ce moment-là. Le définir sur `false` ne met jamais fin à une location en cours : chaque commande sur le serveur termine sa période en cours et son renouvellement est refusé avec `host_disallowed`.

**Sortie**

| Champ  | Type  | Description |
| ------ | ----- | ----------- |
| `code` | `int` | Code d'état |

**Exemple**

**Entrée :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "name": "Jan Vykydal",
    "availability":true,
    "mrl":96,
    "enabled-bitcoin":true,
    "bitcoin_on_demand":0.0001,
    "bitcoin_spot":0.00000113
}' 'https://api.clore.ai/v1/set_server_settings'
```

**Sortie :**

```
{
  "code": 0
}
```

#### 8. `set_spot_price` <a href="#id-8-set_spot_price" id="id-8-set_spot_price"></a>

**À propos**

Définir le prix par jour de votre offre sur le marché SPOT

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ           | Type    | Obligatoire | Description                |
| --------------- | ------- | ----------- | -------------------------- |
| `order_id`      | `int`   | Oui         | ID unique de l'offre       |
| `desired_price` | `float` | Oui         | Votre prix offert par jour |

> **Un prix inférieur au plancher spot actuel du serveur** est rejeté avec le minimum actuel inclus :
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
>
> **Une hausse doit être d'au moins 1 % au-dessus à la fois de votre offre actuelle et de l'offre la plus élevée du serveur dans la même devise** (arrondie à la précision de la devise, plafonnée au prix maximum). Une hausse plus faible est rejetée avec le prix minimal accepté :
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Exemple**

Essayons de mettre à jour le prix spot du marché

**Entrée 1 (la baisse était trop importante) :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000200
}' 'https://api.clore.ai/v1/set_spot_price'
```

**Sortie possible 1 (la baisse était trop importante) :**\
Vous pouvez baisser le prix de l'offre spot de marché d'au maximum 0.00000100 ₿

| Champ      | Type     | Description                                                               |
| ---------- | -------- | ------------------------------------------------------------------------- |
| `code`     | `int`    | Code d'état                                                               |
| `erreur`   | `chaîne` | Champ de description de l'erreur                                          |
| `max_step` | `float`  | Valeur minimale jusqu'à laquelle vous pouvez actuellement baisser le prix |

```
{
    "error":"exceeded_max_step",
    "max_step":0.0000032,
    "code":6
}
```

**Entrée 2 (baisse de prix valide) :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000320
}' 'https://api.clore.ai/v1/set_spot_price'
```

**Sortie possible 2 (baisse de prix valide) :**

```
{
    "code": 0
}
```

**Entrée 3 (baisser encore plus le prix après l'envoi de l'entrée 2) :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000220
}' 'https://api.clore.ai/v1/set_spot_price
```

**Sortie possible 3 (baisser encore plus le prix après l'envoi de l'entrée 2) :**\
Vous pouvez baisser le prix spot une fois toutes les 600 secondes

| Champ              | Type     | Description                                                                     |
| ------------------ | -------- | ------------------------------------------------------------------------------- |
| `code`             | `int`    | Code d'état                                                                     |
| `erreur`           | `chaîne` | Champ de description de l'erreur                                                |
| `time_to_lowering` | `float`  | Temps restant (en secondes) jusqu'à la prochaine possibilité de baisser le prix |

```
{
    "error":"can_lower_every_600_seconds",
    "time_to_lowering":513,
    "code":6
}
```

#### 9. `cancel_order` <a href="#id-9-cancel_order" id="id-9-cancel_order"></a>

**À propos**

Annuler une commande active ou une offre spot

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ      | Type     | Obligatoire | Description                                                                                                                                |
| ---------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`       | `int`    | Oui         | ID unique de la commande/de l'offre                                                                                                        |
| `problème` | `chaîne` | Non         | Si vous avez rencontré un problème avec le serveur, vous pouvez le signaler à [clore.ai](http://clore.ai/) équipe, 2048 caractères maximum |

**Sortie**

| Champ  | Type  | Description |
| ------ | ----- | ----------- |
| `code` | `int` | Code d'état |

**Exemple**

Annuler la commande/l'offre

**Entrée :**\
Dans cet exemple, nous signalons des problèmes avec le GPU #1 ; si vous n'avez pas de problème, n'incluez pas le champ issue.\
Vous pouvez écrire n'importe quel message dans le champ text et nous l'examinerons

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"GPU #1 Was overheating and throttling"
}' 'https://api.clore.ai/v1/cancel_order'
```

**Sortie :**

```
{
  "code": 0
}
```

#### 10. `create_order` <a href="#id-10-create_order" id="id-10-create_order"></a>

**À propos**

Vous pouvez créer une offre spot ou une commande à la demande avec ce point de terminaison

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ                  | Type     | Obligatoire | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency`             | `chaîne` | Oui         | Nom de la devise                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `image`                | `chaîne` | Oui         | Image valide depuis Docker Hub                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `renting_server`       | `int`    | Oui         | ID du serveur que vous souhaitez louer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `type`                 | `chaîne` | Oui         | `à la demande` OU `spot`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `spotprice`            | `float`  | Dépend      | Prix offert par jour sur le marché spot, requis lors de la création d'une commande spot                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `ports`                | `objet`  | Non         | Configuration de redirection de ports, 5 enregistrements maximum                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `env`                  | `objet`  | Non         | <p>Variables d'environnement, limitées à 12288 caractères au total une fois sérialisées.<br>Nom de variable - 128 caractères max, ne doit pas contenir <code>-</code><br>Valeur de variable - 1536 caractères max<br>Seules les 30 premières variables valides sont conservées ; les autres sont ignorées silencieusement</p>                                                                                                                                                                                                     |
| `jupyter_token`        | `chaîne` | Non         | Jeton Jupyter pour les images contenant des notebooks Jupyter, 32 caractères maximum \*                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `ssh_key`              | `chaîne` | Non         | Clé SSH pour les images avec SSH, 3072 caractères maximum \*                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `ssh_password`         | `chaîne` | Non         | Mot de passe SSH pour les images avec SSH, 32 caractères maximum \*                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `command`              | `chaîne` | Non         | La commande sera exécutée sur le serveur après la création de la commande                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `required_price`       | `float`  | Non         | Spécifiez le prix à partir duquel vous souhaitez démarrer la commande ; si le propriétaire de la machine modifie le prix, la commande ne démarrera pas (à la demande uniquement)                                                                                                                                                                                                                                                                                                                                                  |
| `gpu_count`            | `int`    | Non         | Nombre de GPU à louer sur les serveurs qui prennent en charge [location partielle](https://docs.clore.ai/clore.ai/clore.ai-eng-fr/pour-les-locataires/partial-gpu-rental.md). Omettez pour louer l'ensemble de la machine. À la demande uniquement, machines homogènes uniquement                                                                                                                                                                                                                                                 |
| `gpu_indices`          | `[]int`  | Non         | Indices 0-based des emplacements GPU à louer ; la longueur doit être égale à `gpu_count`. Prendre les emplacements libres depuis `partial_gpu_rental.free_indices`. Omettez pour laisser le backend choisir automatiquement les GPU libres                                                                                                                                                                                                                                                                                        |
| `autossh_entrypoint`   | `bool`   | Non         | Utiliser le point d'entrée clore.ai, qui déploie automatiquement un serveur SSH et un `/root/onstart.sh` script                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `rental_hours`         | `int`    | Non         | À la demande uniquement. Pendant combien de temps vous voulez la machine, en heures entières de 1 à 3000 (le maximum de la plateforme), comptées à partir de la création de la commande. Omettez-le pour demander aucune limite : la commande se termine alors à `mrl` sauf si `auto_renew` activé, auquel cas elle s'exécute jusqu'à votre annulation. Une valeur supérieure au `mrl` requiert `auto_renew: true`; une valeur égale ou inférieure met fin à la commande après ce nombre d'heures. Ignoré pour les commandes spot |
| `auto_renew`           | `bool`   | Non         | À la demande uniquement. Lorsque la durée maximale de location du serveur est atteinte, renouveler la commande sur le même conteneur au prix actuel du serveur, tant que ce prix est inférieur ou égal à `auto_renew_max_price`, jusqu'à ce que `rental_hours` soient utilisés, ou jusqu'à ce que vous annuliez lorsque `rental_hours` est omis. Aucun frais de création n'est facturé lors d'un renouvellement. Refusé pour les commandes spot et sur les serveurs dont `auto_renew_allowed` est `false`                         |
| `auto_renew_max_price` | `float`  | Dépend      | Requis lorsque `auto_renew` est `true`. Limite de prix journalier dans la devise de la commande, supérieure à 0 et au plus égale au prix maximum du marché pour cette devise (0.1 BTC, 5,000,000 CLORE, 10,000 USD). À chaque renouvellement, elle est comparée au prix par jour du serveur, ramené à `gpu_count` sur une location partielle                                                                                                                                                                                      |

\* Dans les champs marqués d'une étoile, vous ne pouvez saisir que des caractères de ce groupe regexp `/^[a-zA-Z0-9\s-=.@+/]+$/`

**Sortie**

| Champ    | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`   | `int`    | Code d'état                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `erreur` | `chaîne` | Présent avec le code `6` (HTTP 200) lorsque la commande est refusée. Refus liés à la durée de location et au renouvellement automatique : `invalid_rental_hours` (n'est pas un nombre entier de 1 à 3000, ou `null`), `rental_hours_exceeds_mrl` (au-dessus du `mrl` sans `auto_renew: true`), `invalid_auto_renew` (`auto_renew` n'est pas un booléen, ou il est `true` sans une valeur positive `auto_renew_max_price`, ou avec une valeur supérieure au prix maximum du marché pour la devise), `auto_renew_not_supported` (`auto_renew: true` sur une commande spot), `auto_renew_not_allowed` (le serveur n'autorise pas le renouvellement automatique). Les refus d'offres spot sont décrits ci-dessous |

> **Les offres spot inférieures au plancher du serveur** sont rejetées avec le minimum actuel inclus, afin que vous puissiez réessayer immédiatement :
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Le plancher est recalculé à partir des taux des cryptos en temps réel environ toutes les 10 minutes, donc un prix lu dans la liste du marché peut être légèrement obsolète — utilisez toujours le `min_price` renvoyé pour la tentative suivante.
>
> **Lorsque le serveur a déjà des offres spot dans la même devise**, une nouvelle offre doit être d'au moins 1 % supérieure à la meilleure offre (arrondie à la précision de la devise, plafonnée au prix maximum). Une offre plus basse est rejetée avec le prix minimal accepté :
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Exemple**

**Entrée 1 (créer une offre spot) :**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"spot",
    "spotprice":0.000001,
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**Sortie 1 (Créer une offre spot) :**

```
{
  "code":0
}
```

**Entrée 2 (Créer une commande à la demande) :**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"on-demand",
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**Sortie 2 (Créer une commande à la demande) :**

```
{
  "code":0
}
```

**Entrée 3 (Commande à la demande pour 48 heures avec renouvellement automatique) :**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"CLORE-Blockchain",
    "image":"cloreai/jupyter:ubuntu24.04-v2",
    "renting_server":6,
    "type":"on-demand",
    "rental_hours":48,
    "auto_renew":true,
    "auto_renew_max_price":250
}' 'https://api.clore.ai/v1/create_order'
```

**Sortie 3 (Commande à la demande pour 48 heures avec renouvellement automatique) :**

```
{
  "code":0
}
```

Sur un serveur avec une période de 24 heures `mrl` la première période dure 24 heures. À son terme, la commande se renouvelle pour 24 heures supplémentaires au prix du serveur à ce moment-là, si celui-ci est inférieur ou égal à 250 CLORE par jour ; elle se termine ensuite parce que les 48 heures demandées sont écoulées. Avec `auto_renew` activé, en omettant `rental_hours` le fait continuer à se renouveler jusqu’à ce que vous l’annuliez. Sans `auto_renew`, la même `rental_hours` sur ce serveur est refusée :

```
{ "error": "rental_hours_exceeds_mrl", "code": 6 }
```

#### 11. `renter_fees` <a href="#id-11-renter_fees" id="id-11-renter_fees"></a>

**À propos**

Obtenez la configuration actuelle des frais : frais de base du locataire, paramètres de réduction des frais PoH, frais de création de commande et votre solde PoH

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Sortie**

| Champ                              | Type    | Description                                                  |
| ---------------------------------- | ------- | ------------------------------------------------------------ |
| `code`                             | `int`   | Code d'état                                                  |
| `renter_fees.on_demand`            | `objet` | Frais de base (%) par devise pour les commandes à la demande |
| `renter_fees.spot`                 | `objet` | Frais de base (%) par devise pour les commandes spot         |
| `poh_config.max_reduction_percent` | `int`   | Réduction maximale des frais de base via PoH (%)             |
| `poh_config.max_poh_amount`        | `int`   | Solde PoH à partir duquel la réduction maximale est atteinte |
| `creation_fees.on_demand`          | `objet` | Frais de création de commande par devise                     |
| `creation_fees.spot`               | `objet` | Frais de création de commande spot par devise                |
| `poh_balance`                      | `float` | Votre solde PoH CLORE                                        |

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```

**Sortie :**

```
{
  "renter_fees": {
    "on_demand": {
      "base": { "bitcoin": 5, "CLORE-Blockchain": 5, "USD-Blockchain": 5 }
    },
    "spot": {
      "base": { "bitcoin": 1.25, "CLORE-Blockchain": 1.25, "USD-Blockchain": 1.25 }
    }
  },
  "poh_config": { "max_reduction_percent": 50, "max_poh_amount": 2000000 },
  "creation_fees": {
    "on_demand": { "bitcoin": 3e-7, "CLORE-Blockchain": 0.5, "USD-Blockchain": 0.1 },
    "spot": { "bitcoin": 1e-7, "CLORE-Blockchain": 0.05, "USD-Blockchain": 0.005 }
  },
  "poh_balance": 5000,
  "code": 0
}
```

#### 12. `cancel_orders` <a href="#id-12-cancel_orders" id="id-12-cancel_orders"></a>

**À propos**

Annulez plusieurs commandes à la fois (jusqu’à 256 par requête)

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ       | Type    | Obligatoire | Description                                       |
| ----------- | ------- | ----------- | ------------------------------------------------- |
| `order_ids` | `[]int` | Oui         | Identifiants des commandes à annuler, 256 maximum |

**Sortie**

| Champ              | Type    | Description                                               |
| ------------------ | ------- | --------------------------------------------------------- |
| `code`             | `int`   | Code d'état                                               |
| `failed_to_cancel` | `[]int` | Identifiants des commandes qui n’ont pas pu être annulées |

**Entrée :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```

**Sortie :**

```
{
  "failed_to_cancel": [],
  "code": 0
}
```

#### 13. `poh_balance` <a href="#id-13-poh_balance" id="id-13-poh_balance"></a>

**À propos**

Obtenez votre solde Proof of Holding : éléments, totaux et montants des offres du marché PoH

**En-têtes**

| Champ  | Type     | Obligatoire | Description |
| ------ | -------- | ----------- | ----------- |
| `auth` | `chaîne` | Oui         | Jeton d'API |

**Sortie**

| Champ                                         | Type      | Description                                  |
| --------------------------------------------- | --------- | -------------------------------------------- |
| `code`                                        | `int`     | Code d'état                                  |
| `items`                                       | `[]objet` | Vos éléments PoH avec des soldes individuels |
| `balance.total`                               | `float`   | Solde total PoH sur tous les éléments        |
| `balance.free_amount`                         | `float`   | Solde PoH non engagé dans des offres         |
| `balance.reward_amount`                       | `float`   | Solde éligible aux récompenses               |
| `balance.offers.rented_amount`                | `float`   | Montant loué à d’autres utilisateurs         |
| `balance.offers.rented_on_marketplace_amount` | `float`   | Montant listé sur la place de marché PoH     |
| `balance.offers.leased_amount`                | `float`   | Montant loué auprès d’autres utilisateurs    |

**Entrée :**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```

**Sortie :**

```
{
  "items": [ { "balance": 5000 } ],
  "balance": {
    "total": 5000,
    "free_amount": 4000,
    "reward_amount": 5000,
    "offers": {
      "rented_amount": 0,
      "rented_on_marketplace_amount": 1000,
      "rented_finished_amount": 0,
      "leased_amount": 0
    }
  },
  "code": 0
}
```

#### 14. `server-config.json` <a href="#id-14-server-config-json" id="id-14-server-config-json"></a>

**À propos**

Obtenez des données de configuration API statiques. Aucune authentification requise

**Entrée :**

```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```

#### 15. `get_relay` <a href="#id-15-get_relay" id="id-15-get_relay"></a>

**À propos**

Obtenez les nœuds relais de transfert TCP pour votre pays détecté. Aucune authentification requise

**Sortie**

| Champ     | Type     | Description              |
| --------- | -------- | ------------------------ |
| `code`    | `int`    | Code d'état              |
| `country` | `chaîne` | Code pays détecté        |
| `nodes`   | `objet`  | Nœuds relais disponibles |

**Entrée :**

```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```

#### 16. `set_order_auto_renew` <a href="#id-16-set_order_auto_renew" id="id-16-set_order_auto_renew"></a>

**À propos**

Modifiez la durée de location demandée, le renouvellement automatique et sa limite de prix pour votre commande active à la demande. Envoyez uniquement les champs que vous souhaitez modifier ; un champ omis conserve sa valeur actuelle. POST uniquement ; un GET renvoie le code `4`.

* La période en cours se termine alors à la fin demandée ou à `term_start + term_mrl`, selon la première éventualité, et jamais avant 60 secondes à compter de maintenant. `mrl` et `term_end` la modification pour correspondre. Dépasser `term_start + term_mrl` nécessite `auto_renew`, et le renouvellement en fin de période le recalcule.
* Allonger la demande au-delà de `term_start + term_mrl` n'est possible que lorsque `auto_renew` est activé ; sinon, la demande est refusée avec `rental_hours_exceeds_mrl`. Modifier un paramètre `rental_hours` en `null` alors que `auto_renew` reste désactivé compte comme un allongement, et une modification qui active `auto_renew` désactivé tout en envoyant de nouvelles `rental_hours` dont la fin dépasse `term_start + term_mrl` est refusée de la même manière.
* Raccourcir la demande sans désactiver `auto_renew` dans la même modification est toujours accepté, et tout comme le fait de désactiver `auto_renew` sans nouvelles heures ou avec `rental_hours: null`. Si la nouvelle `rental_hours` heures sont déjà écoulées, la commande se termine environ une minute après la modification. Pour arrêter une location immédiatement, utilisez [`cancel_order`](#id-9-cancel_order).
* `rental_hours: null` supprime la limite demandée : avec `auto_renew` activé, la commande continue alors jusqu’à ce que vous l’annuliez.
* À partir de 60 secondes avant la fin d’une période et jusqu’à ce que la période ait été renouvelée ou que la commande se soit terminée, la modification est refusée avec `renewal_in_progress`. Relisez la commande avec [`my_orders`](#id-5-my_orders) et réessayez.
* Sur une commande créée avant le déploiement du renouvellement automatique, la première modification définit `term_start` à l'heure de création et `term_mrl` au `mrl`de la commande, donc sans `auto_renew` elle ne peut pas dépasser sa fin initiale.

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ                  | Type            | Obligatoire | Description                                                                                                                                                                                                                                                                                  |
| ---------------------- | --------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | `int`           | Oui         | ID unique de la commande                                                                                                                                                                                                                                                                     |
| `rental_hours`         | `int` \| `null` | Non         | Nouvelle durée demandée en heures entières (1 à 3000), comptée à partir de la création de la commande. `null` supprime la limite demandée. Omettez-le pour conserver la valeur actuelle                                                                                                      |
| `auto_renew`           | `bool`          | Non         | Renouveler au prix actuel de l'hôte lorsque la période en cours se termine. Omettez-le pour conserver la valeur actuelle. L'activation est refusée lorsque le `auto_renew_allowed` est `false`                                                                                               |
| `auto_renew_max_price` | `float`         | Dépend      | Limite de prix par jour dans la devise de la commande, supérieure à 0 et au plus égale au prix maximal du marché pour cette devise. Requise lorsque cette modification active `auto_renew` et que la commande n'a encore aucune limite ; sinon, omettez-la pour conserver la limite actuelle |

**Sortie**

| Champ    | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`   | `int`    | Code de statut. `2` (HTTP 400) lorsque le corps a un type incorrect, par exemple un manquant ou non entier `order_id`, `rental_hours` qui n'est ni un nombre entier ni `null`, un non booléen `auto_renew` ou un non numérique `auto_renew_max_price`; ceci est vérifié avant toute erreur ci-dessous                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `erreur` | `chaîne` | Présent avec le code `6` (HTTP 200) : `you_dont_own_this_order` (la commande n'existe pas ou ne vous appartient pas), `order_not_active` (une commande spot ou fermée, une commande en cours d'annulation, ou une commande qui s'est terminée pendant l'enregistrement de la modification), `renewal_in_progress` (la période en cours se termine dans les 60 secondes, ou la commande a changé pendant l'enregistrement de la modification ; relisez la commande et réessayez), `invalid_rental_hours` (inférieur à 1 ou supérieur à 3000), `rental_hours_exceeds_mrl` (voir les règles ci-dessus), `invalid_auto_renew` (`auto_renew` (se retrouve activé sans limite de prix valide), `auto_renew_not_allowed` (la modification active `auto_renew` et le serveur n'autorise pas le renouvellement automatique) |

**Exemple**

**Entrée 1 (Continuer le renouvellement jusqu’à annulation) :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "rental_hours":null,
    "auto_renew":true,
    "auto_renew_max_price":30
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**Sortie 1 (Continuer le renouvellement jusqu’à annulation) :**

```
{
  "code": 0
}
```

**Entrée 2 (Arrêter le renouvellement, la commande se termine à la fin de sa période en cours) :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "auto_renew":false
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**Sortie 2 (Arrêter le renouvellement, la commande se termine à la fin de sa période en cours) :**

```
{
  "code": 0
}
```

Envoyée dans les 60 dernières secondes d’une période, la même requête est refusée jusqu’à ce que la commande ait été renouvelée ou se soit terminée :

```
{ "error": "renewal_in_progress", "code": 6 }
```

#### 17. `order_renewals` <a href="#id-17-order_renewals" id="id-17-order_renewals"></a>

**À propos**

Obtenez l'historique de renouvellement de votre commande : une ligne par décision de renouvellement prise à la fin d’une période, renouvelée ou refusée, la plus récente d’abord, 1000 lignes maximum. Une commande n'ayant jamais atteint une décision de renouvellement renvoie une liste vide, et la fin à laquelle une commande s'arrête parce que ses heures demandées sont écoulées ne laisse aucune ligne. POST uniquement ; un GET renvoie le code `4`.

**En-têtes**

| Champ             | Type     | Obligatoire | Description                  |
| ----------------- | -------- | ----------- | ---------------------------- |
| `auth`            | `chaîne` | Oui         | Jeton d'API                  |
| `Type de contenu` | `chaîne` | Oui         | Doit être `application/json` |

**Corps**

| Champ      | Type  | Obligatoire | Description              |
| ---------- | ----- | ----------- | ------------------------ |
| `order_id` | `int` | Oui         | ID unique de la commande |

**Sortie**

| Champ                      | Type      | Description                                                                                                                                                                                                                                                                   |
| -------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                     | `int`     | Code de statut. `2` (HTTP 400) lorsque `order_id` est manquant ou n'est pas un entier                                                                                                                                                                                         |
| `erreur`                   | `chaîne`  | `you_dont_own_this_order` avec le code `6` (HTTP 200) lorsque la commande n'existe pas ou ne vous appartient pas                                                                                                                                                              |
| `renouvellements`          | `[]objet` | Décisions de renouvellement, de la plus récente à la plus ancienne ; présentes uniquement en cas de succès                                                                                                                                                                    |
| `renewals[x].order_id`     | `int`     | ID unique de la commande                                                                                                                                                                                                                                                      |
| `renewals[x].renewal_no`   | `int`     | Le numéro que ce renouvellement a, ou aurait eu, parmi les renouvellements de la commande, en comptant à partir de 1                                                                                                                                                          |
| `renewals[x].outcome`      | `chaîne`  | `renouvelé` ou `refusé`                                                                                                                                                                                                                                                       |
| `renewals[x].reason`       | `chaîne`  | Lignes refusées uniquement : `price_above_cap`, `server_unlisted`, `host_disallowed`, `server_reserved` ou `insufficient_balance` (voir `orders[x].auto_renew_declined` dans [`my_orders`](#id-5-my_orders))                                                                  |
| `renewals[x].decided_at`   | `int`     | Heure UNIX de la décision, prise lorsque la période était terminée                                                                                                                                                                                                            |
| `renewals[x].applied_at`   | `int`     | Heure UNIX à laquelle il a été confirmé que le renouvellement avait pris effet. Absent en cas de refus et pour une décision de renouvellement qui n’a pas été confirmée ; une décision peut rester non appliquée lorsque la commande a été annulée ou modifiée au même moment |
| `renewals[x].old_price`    | `float`   | Prix par jour de la période qui s’est terminée                                                                                                                                                                                                                                |
| `renewals[x].new_price`    | `float`   | Prix par jour de la nouvelle période, ou en cas de refus, le prix de l'hôte qui a été refusé ; absent lorsqu'aucun prix n'a pu être calculé                                                                                                                                   |
| `renewals[x].cap`          | `float`   | Votre limite de prix par jour au moment de la décision                                                                                                                                                                                                                        |
| `renewals[x].term_seconds` | `int`     | Durée de la nouvelle période en secondes ; `0` en cas de refus                                                                                                                                                                                                                |
| `renewals[x].term_start`   | `int`     | Heure UNIX de début de la nouvelle période (la fin de la précédente) ; en cas de refus, début de la période qui s’est terminée                                                                                                                                                |
| `renewals[x].term_end`     | `int`     | Heure UNIX de fin de la nouvelle période ; en cas de refus, fin de la période qui s’est terminée                                                                                                                                                                              |

**Exemple**

**Entrée :**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345
}' 'https://api.clore.ai/v1/order_renewals'
```

**Sortie :**

Dans cet exemple, la commande a été renouvelée une fois à 24 par jour, dans la limite de 30. À la fin de cette période, le prix de l'hôte était de 36, au-dessus de la limite, donc le renouvellement a été refusé et la commande s'est terminée avec cette période.

```
{
  "renewals": [
    {
      "order_id": 12345,
      "renewal_no": 2,
      "outcome": "declined",
      "reason": "price_above_cap",
      "decided_at": 1792209661,
      "old_price": 24,
      "new_price": 36,
      "cap": 30,
      "term_seconds": 0,
      "term_start": 1792188060,
      "term_end": 1792209660
    },
    {
      "order_id": 12345,
      "renewal_no": 1,
      "outcome": "renouvelée",
      "decided_at": 1792188061,
      "applied_at": 1792188061,
      "old_price": 20,
      "new_price": 24,
      "cap": 30,
      "term_seconds": 21600,
      "term_start": 1792188060,
      "term_end": 1792209660
    }
  ],
  "code": 0
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-fr/pour-les-hotes/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
