# Отправка кода подтверждения

## Отправка кода

<mark style="color:green;">`POST`</mark> `https://direct.i-dgtl.ru/api/v1/verifier/send`

Запрос позволяет отправить код подтверждения по условиям настроенного модуля

#### Headers

| Name                                            | Type   | Description        |
| ----------------------------------------------- | ------ | ------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | `Basic {TOKEN_3}`  |
| Content-Type<mark style="color:red;">\*</mark>  | String | `application/json` |

#### Request Body

| Name                                          | Type   | Description                                                                                                        |
| --------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------ |
| gatewayId<mark style="color:red;">\*</mark>   | String | ID модуля подтверждения (указан на странице в ЛК)                                                                  |
| channelType<mark style="color:red;">\*</mark> | String | Канал отправки кода, настроенный в модуле. Допускаются значения `SMS, VK, VIBER, WHATSAPP, WEASY,TELEGRAM GATEWAY` |
| destination<mark style="color:red;">\*</mark> | String | Номер абонента в международном формате. Только цифры.                                                              |
| substitutions                                 | Json   | Объект с подстановками для текста сообщения                                                                        |

{% hint style="info" %}
Использование подстановок позволяет передавать в сообщении с кодом какие-либо уникальные данные (например, ссылку на договор).

По умолчанию для модуля доступны только шаблоны без возможности подстановок – для использования подстановок в ваших шаблонах обратитесь к вашему менеджеру.
{% endhint %}

{% tabs %}
{% tab title="200: OK" %}
Код передан к отправке. Возвращается идентификатор, который необходимо использовать для проверки

```
{
  "uuid": "b8e52cdd-f5de-4c3c-95bc-63e841c70be9"
}
```

{% endtab %}

{% tab title="429: Too Many Requests" %}
Код HTTP 429 сообщает о превышении количества запросов на один номер в единицу времени (ограничение устанавливается в настройках модуля в личном кабинете).

Сообщение не будет отправлено.
{% endtab %}
{% endtabs %}

## Пример тела запроса 1&#x20;

Отправка кода в SMS из-под модуля с id = Abc123 на номер +7 000 000 00 00

```
{
  "gatewayId": "Abc123",
  "channelType": "SMS",
  "destination": "70000000000"
}
```

## Пример тела запроса 2

Отправка кода в VK из-под модуля с id = dEf456 на номер +7 123 456 78 90 с подстановками для текста сообщения:

```
{
  "gatewayId": "dEf456",
  "channelType": "VK",
  "destination": "71234567890",
  "substitutions": {
    "link": "https://example.com",
    "name": "Иван"
  }
}
```

{% hint style="info" %}
Ключи для подстановок должны соответствовать названиям подстановок в шаблоне. Для использования шаблонов с подстановками обратитесь к вашему менеджеру.
{% endhint %}


---

# 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://api.docs.direct.i-dgtl.ru/verifier/api/send.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.