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

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


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.edgegap.com/docs.edgegap.com-fr/docs/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.