# API

Web API Fasttrack позволяет производить более сложную интеграцию и использовать все возможности платформы на полную мощность.

Быстрая навигация:

* Авторизация
* Общее описание
* Пагинация
* Методы
* Лимиты
* Ошибки

### Авторизация

Каждый запрос к API должен сопровождаться заголовком `bot-key`. Ключ можно получить в разделе «Системные настройки»:

<figure><img src="/files/KReAPHYMlpCBStZpwU4F" alt=""><figcaption></figcaption></figure>

### Общее описание

Web API выдержан в стиле REST. Описание всех доступных методов — доступно в [Swagger](https://dashboard.fstrk.io/api/partners/docs/#/Push-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F/push_messages_list).

Взаимодействовать с API возможно только по протоколу HTTPS.

> **Примечание:** Базовый URL Web API Fasttrack: `https://dashboard.fstrk.io/api/partners`

### Пагинация

В методах API, которые возвращают множество объектов, используется пагинация списка:

* `limit` — кол-во возвращаемых объектов;
* `offset` — сдвиг на количество объектов (то количество, которое следует пропустить учитывая все фильтры и сортировки).

Максимальное количество объектов на странице (`limit`) равняется **100**.

### Методы

Все доступные методы API описаны в [Swagger](https://dashboard.fstrk.io/api/partners/docs/).

### Лимиты

Максимально допустимое количество запросов через API для одного бота — 5 в секунду.

> **Примечание:** При превышении лимита: сервер будет отвечать статусом **429** (*Too Many Requests*).

### Ошибки

Все возможные ошибки с кодами ответов описаны в [Swagger](https://dashboard.fstrk.io/api/partners/docs/).


---

# 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.fstrk.io/knowledge_base/instructions/old/webhook-i-web-api/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.
