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

# API Методы

Методы API позволяют вам интегрировать платформу LeadConverter с любыми другими сервисами и скриптами.

Для того, чтобы начать использовать API, вам необходимо сгенерировать токен. Перейдите в **Настройки**, затем сверху выберите вкладку **API.** Нажмите кнопку **Создать новый токен.**

![Пример создания нового токена](/files/-Ma0IbSzTlJYISZG9N6W)

Дождитесь создания токена.

{% hint style="danger" %}
**Внимание!** Никому не передавайте и не показывайте токен. С его помощью злоумышленник может получить доступ к функциям вашего кабинета.
{% endhint %}

### Секретный ключ

Секретный ключ необходим для обеспечения дополнительной безопасности. С его помощью можно быть уверенным, что запрос был инициирован вами, а не злоумышленником.

{% hint style="info" %}
Секретный ключ указывать не обязательно, однако мы рекомендуем использовать его для повышения безопасности ваших данных
{% endhint %}

Вы можете как указать свой произвольный секретный ключ, так и сгенерировать его, нажав на кнопку <img src="/files/-Ma0KBvZ4Mx3u5vDPrcM" alt="" data-size="line">

После заполнения секретного ключа нажмите кнопку "сохранить".

![Пример генерации нового секретного ключа](/files/-Ma0K9eqCKIhZH2gbodb)

{% hint style="info" %}
Если вы указали секретный ключ - вам необходимо передавать дополнительный параметр **secret** с каждым запросом к API. В значении параметра необходимо указывать ваш секретный ключ.
{% endhint %}

Если секретный ключ не указан - параметр secret можно не передавать

Если секретный ключ указан, и параметр secret содержит неправильное значение - сервер вернёт ошибку **403**

### **Методы запросов**

Для того, чтобы вызвать метод API, вы можете использовать **GET**, **POST**, либо **JSON POST** запрос.

Запрос необходимо отправить по адресу&#x20;

```
https://leadconverter.ru/api/v1/ваш_токен/метод_апи
```

#### Рассмотрим на примере

Для того, чтобы отправить запрос на запуск бота на токен

![](/files/-Ma0NuB9rvrkkDZFWj3f)

Нам необходимо отправить запрос&#x20;

## Пример отправки запроса на запуск бота

<mark style="color:blue;">`GET`</mark> `https://leadconverter.ru/api/v1/d7K67GmCpE5uJ1Q0APSTCNWKrkGyFRHG/bot.start`

Так же необходимо передать следующие параметры:

#### Query Parameters

| Name    | Type    | Description                            |
| ------- | ------- | -------------------------------------- |
| secret  | string  | secret                                 |
| bot\_id | integer | ID бота, которого необходимо запустить |
| id      | integer | ID подписчика, которому запускаем бота |

{% tabs %}
{% tab title="200 " %}

```
ok
```

{% endtab %}
{% endtabs %}

## Что, если нужного мне метода нет в списке?

Напиши нам в поддержку:point\_down: \
Мы подумаем, как решить твой вопрос. По необходимости добавим новый метод. \
Не решаемых проблем не бывает:slight\_smile:

## Я ничего не понял...

{% hint style="info" %}
Если у тебя остались вопросы - не стесняйся, обращайся в поддержку, мы с радостью тебе поможем :)
{% endhint %}

{% content-ref url="/pages/-MasAPNcg291uNezFqb4" %}
[Как задать вопрос в поддержку?](/kak-zadat-vopros-v-podderzhku.md)
{% endcontent-ref %}