> 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/ru/docs/api.md).

# Справочник API

Получите доступ к функциям управления вашими ресурсами Edgegap с помощью HTTP-запросов.

<a href="https://raw.githubusercontent.com/edgegap/openapi-specification/refs/heads/main/edgegap-v2-openapi.yaml" class="button primary" data-icon="square-down">Скачать 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">Скачать openapi \[v1]</a>&#x20;

{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Токен аутентификации

Создавайте (и просматривайте) свои секретные токены для Edgegap API в [Панель управления - Настройки пользователя / Токены](https://app.edgegap.com/user-settings?tab=tokens).

Добавляйте свой секретный токен к каждому API-запросу в виде HTTP-заголовка (включите слово `token`):

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

{% hint style="danger" %}
**Не интегрируйте конечные точки Edgegap API в игровой клиент, поскольку ваш API-токен предоставляет неограниченный доступ к вашей учетной записи. См.** [Интеграция](/ru/docs/api/integraciya.md) **для безопасных клиентских конечных точек и функций API.**
{% endhint %}

{% hint style="success" %}
Если ваши секретные токены были скомпрометированы, удалите их и обновите пароли участников организации.
{% endhint %}

### Пагинация ответа

Если ответ содержит слишком много элементов, мы возвращаем часть данных с информацией о пагинации:

<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">пагинация</a>": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": null
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}
</code></pre>

Для ответа с пагинацией используйте параметры `page` и `limit`  чтобы получить больше результатов:

* вторая страница: `https://api.edgegap.com/v1/apps?`**`page=2`**
* больше результатов: `https://api.edgegap.com/v1/apps?`**`limit=20`**
* в сочетании: `https://api.edgegap.com/v1/apps?`**`page=2&limit=20`**

### Ограничение частоты запросов

Чтобы обеспечить стабильность платформы и предотвратить неожиданные счета, мы ограничиваем частоту использования API вашей организацией:

* [Развертывания](/ru/learn/orkestraciya/deployments.md) до 40 запросов в секунду,
* [Развертывания](/ru/learn/orkestraciya/deployments.md#context-and-status) до 20 запросов в секунду.

{% hint style="info" %}
[Свяжитесь с нами](mailto:info@edgegap.com) в **планировать релизы, проводить нагрузочные тесты, оценивать трафик на запуске и готовиться к успеху.**
{% endhint %}

[^1]: содержит информацию о пагинации