Документация для версии v72
Получить информацию о шаблоне
Описание
Получить информацию о шаблоне сообщения.
URL-адрес
Метод: POST
https://example.com/api/v1.1/templates/get
Параметры запроса
| Параметр | Тип | Пример | Обязательный | Описание |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
| format | string | "json" | Нет | Формат возвращаемых данных (по умолчанию – "json") |
| id | int | 1 | Да | Идентификатор шаблона сообщения |
Пример запроса
- JSON
- XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"id": 1
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<id>1</id>
</xml>
Пример ответа
- JSON
- XML
{
"data": {
"id": 1,
"updated_user": "ivan_ivanov",
"update_time": "2025-05-21T09:17:53.362Z",
"name": "Название шаблона",
"description": "Описание шаблона",
"channels": [
{
"id": 1,
"sid": "email",
"fields": {
"text": "Текстовая версия письма",
"html": "<html>Hello, world!</html>",
"subject": "Тема сообщения",
"from_email": "",
"from_name": "",
"replyto_email": "",
"replyto_name": "",
"is_not_inline": true,
"attach": []
},
"presets": null
},
{
"id": 2,
"sid": "sms",
"fields": {
"sms": "Hello, world!",
"sms_max_count": 0,
"add_sms_url_scheme": false
},
"presets": null
},
{
"id": 4,
"sid": "push",
"fields": {
"title": "Заголовок уведомления",
"body": "Hello, world!",
"icon": "",
"click_url": "ttps://example.com",
"click_url_new": {
"uniq": false
},
"custom_push_json_raw": "{}"
},
"presets": null
}
],
"json_url": "https://example.com/examples/message.json",
"is_draft": true,
"is_confirm": true,
"ui_tags": [
"E-commerce",
"B2C"
],
"groups": [
{
"id": 2,
"name": "Отдел продаж"
},
{
"id": 3,
"name": "Отдел маркетинга"
}
],
"suppress_id": 1
},
"error": 0,
"error_text": "Successful operation"
}
<xml>
<data>
<id>1</id>
<updated_user>ivan_ivanov</updated_user>
<update_time>2025-05-21T09:17:53.362Z</update_time>
<name>Название шаблона</name>
<description>Описание шаблона</description>
<channels>
<id>1</id>
<sid>email</sid>
<fields>
<text>Текстовая версия письма</text>
<html><html>Hello, world!</html></html>
<subject>Тема сообщения</subject>
<from_email>noreply@example.com</from_email>
<from_name>Awesome Books</from_name>
<replyto_email></replyto_email>
<replyto_name></replyto_name>
<is_not_inline>true</is_not_inline>
<attach array='true'></attach>
</fields>
<presets></presets>
</channels>
<channels>
<id>2</id>
<sid>sms</sid>
<fields>
<sms>Hello, world!</sms>
<sms_max_count>0</sms_max_count>
<add_sms_url_scheme>false</add_sms_url_scheme>
</fields>
</channels>
<channels>
<id>4</id>
<sid>push</sid>
<fields>
<title>Заголовок уведомления</title>
<body>Hello, world!</body>
<icon></icon>
<click_url>https://example.com</click_url>
<click_url_new>
<uniq>false</uniq>
</click_url_new>
<custom_push_json_raw>{}</custom_push_json_raw>
</fields>
</channels>
<json_url>https://example.com/examples/message.json</json_url>
<is_draft>true</is_draft>
<is_confirm>true</is_confirm>
<ui_tags>E-commerce</ui_tags>
<ui_tags>B2C</ui_tags>
<groups>
<id>2</id>
<name>Отдел продаж</name>
</groups>
<groups>
<id>3</id>
<name>Отдел маркетинга</name>
</groups>
<suppress_id>1</suppress_id>
</data>
<error>0</error>
<error_text>Successful operation</error_text>
</xml>
Возвращаемые параметры
| Параметр | Тип | Описание |
|---|---|---|
| error | int | Код ошибки |
| error_text | string | Текст ошибки |
| id | int | Идентификатор шаблона сообщения |
| name | string | Название шаблона сообщения |
| description | string | Описание шаблона |
| channels | array of objects | Данные о настройках шаблона для каждого канала |
| json_url | string | URL для динамического JSON-контента |
| is_draft | bool | Если это черновик, то шаблон нельзя отправить |
| is_confirm | bool | Имеется ли ссылка подтверждения в теле письма |
| ui_tags | []String | Список тегов для поиска |
| groups | array of objects | Список групп для поиска |
| suppress_id | int | Идентификатор стоп-списка |
| updated_user | string | Кем был обновлён шаблон |
| update_time | string | Когда был обновлён шаблон |