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


---

# 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.leadconverter.su/api-metody.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.