# API Методы

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

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

![Пример создания нового токена](https://1545507669-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYOiJSIpC8f-Cm8cOEc%2F-Ma0I1_3Sv-c9w0xc007%2F-Ma0IbSzTlJYISZG9N6W%2Fimage.png?alt=media\&token=ce42f837-15cf-49fe-b60e-a9cab62e48f9)

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

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

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

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

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

Вы можете как указать свой произвольный секретный ключ, так и сгенерировать его, нажав на кнопку <img src="https://1545507669-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYOiJSIpC8f-Cm8cOEc%2F-Ma0I1_3Sv-c9w0xc007%2F-Ma0KBvZ4Mx3u5vDPrcM%2Fimage.png?alt=media&#x26;token=30be56ad-e063-4f59-b014-39e2f06d4718" alt="" data-size="line">

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

![Пример генерации нового секретного ключа](https://1545507669-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYOiJSIpC8f-Cm8cOEc%2F-Ma0I1_3Sv-c9w0xc007%2F-Ma0K9eqCKIhZH2gbodb%2Fimage.png?alt=media\&token=cfc030a4-2e7f-44e4-8a1b-8ccb284416a0)

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

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

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

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

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

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

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

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

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

![](https://1545507669-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYOiJSIpC8f-Cm8cOEc%2F-Ma0LJPxpvacE0bTNx8_%2F-Ma0NuB9rvrkkDZFWj3f%2Fimage.png?alt=media\&token=a6466ed5-3baf-4b2a-8cc0-ed9d7d4a3b4c)

Нам необходимо отправить запрос&#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="kak-zadat-vopros-v-podderzhku" %}
[kak-zadat-vopros-v-podderzhku](https://docs.leadconverter.su/kak-zadat-vopros-v-podderzhku)
{% endcontent-ref %}