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

# Référence de l'API

Accédez aux fonctions de gestion de vos ressources Edgegap à l’aide de requêtes HTTP.

<a href="https://raw.githubusercontent.com/edgegap/openapi-specification/refs/heads/main/edgegap-v2-openapi.yaml" class="button primary" data-icon="square-down">Télécharger OpenAPI \[v2]</a> <a href="http://raw.githubusercontent.com/edgegap/openapi-specification/refs/heads/main/edgegap-v1-openapi.yaml" class="button secondary" data-icon="square-down">Télécharger OpenAPI \[v1]</a>&#x20;

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Jeton d’authentification

Générez (et consultez) vos jetons secrets pour l’API Edgegap dans [Tableau de bord - Paramètres utilisateur / Jetons](https://app.edgegap.com/user-settings?tab=tokens).

Ajoutez votre jeton secret à chaque requête API sous forme d’en-tête HTTP (incluez le mot `token`):

`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`

{% hint style="danger" %}
**N’intégrez pas les points de terminaison de l’API Edgegap dans le client du jeu, car votre jeton API donne un accès illimité à votre compte. Consultez** [Intégration](/docs.edgegap.com-fr/docs/api/integration.md) **pour les points de terminaison et fonctions API sécurisés destinés au client.**
{% endhint %}

{% hint style="success" %}
Si vos jetons secrets sont compromis, supprimez-les et mettez à jour les mots de passe des membres de l’organisation.
{% endhint %}

### Pagination des réponses

Si une réponse contient trop d’éléments, nous renvoyons un sous-ensemble de données avec des informations de pagination :

<pre class="language-json"><code class="lang-json">{
  "total_count": 100,
  "data": ["foo-0", "[...]", "bar-9"],
  "<a data-footnote-ref href="#user-content-fn-1">pagination</a>": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": null
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}
</code></pre>

Pour une réponse paginée, utilisez les paramètres `page` et `limit`  pour récupérer plus de résultats :

* deuxième page : `https://api.edgegap.com/v1/apps?`**`page=2`**
* plus de résultats : `https://api.edgegap.com/v1/apps?`**`limit=20`**
* combiné : `https://api.edgegap.com/v1/apps?`**`page=2&limit=20`**

### Limitation du débit

Pour garantir la stabilité de la plateforme et éviter des factures surprises, nous limitons le débit d’utilisation de l’API de votre organisation :

* [Déploiements](/docs.edgegap.com-fr/learn/orchestration/deployments.md) à 40 requêtes par seconde,
* [Déploiements](/docs.edgegap.com-fr/learn/orchestration/deployments.md#context-and-status) à 20 requêtes par seconde.

{% hint style="info" %}
[Contactez-nous](mailto:info@edgegap.com) sur **planifiez les sorties, effectuez des tests de charge, estimez le trafic de lancement et préparez-vous au succès.**
{% endhint %}

[^1]: contient des informations de pagination