Метод возвращает информацию о заданном шаблоне.
Принцип использования
| Синтаксис и URL для вызова метода |
| getTemplate (int template_id) |
| https://api.unisender.com/ru/api/getTemplate?format=json&api_key=KEY&template_id=ID |
| Аргументы | |
| api_key * | Ключ доступа к API. |
| template_id * | ID пользовательского шаблона. Возвращается методами createEmailTemplate, а также getTemplates или listTemplates. Параметр не обязателен, если указывается system_template_id |
| system_template_id | ID системного шаблона. Возвращается методами getTemplates или listTemplates. |
| format | Формат вывода возвращаемого результата. Может принимать значения html | json, по умолчанию json (формат html предназначен только для визуального просмотра результата, парсер в данном формате работать не будет). |
| Возвращаемое значение | |
| JSON-массив, объект с полями. Описание полей под примером. Пример возвращаемого значения: {
"result": {
"id": "10423223",
"sub_user_login": "",
"title": "test",
"description" : "This is the test template",
"lang_code": "ru",
"subject": "test",
"attachments": "",
"screenshot_url": "https://api.unisender.com/ru/v5/preview/template/
5gkzx4yg4zjae1swo1cqzy1sbui",
"fullsize_screenshot_url":"",
"created": "2020-02-23 13:29:51",
"updated": "2020-04-17 16:31:51",
"message_format": "raw_html",
"type": "user",
"body": "<html>n<head><title></title></head>n<body></body>n</html>",
"raw_body": ""}
}
|
Где:
id - идентификатор шаблона в системе;
sub_user_login - логин субпользователя, который создал шаблон, либо NULL, если письмо создал мастер-пользователь;
title - название шаблона в системе;
description - текстовое описание шаблона;
lang_code - двухбуквенный код языка для автоматического добавления к письму формы отписки (например, 'ru', 'en');
subject - тема шаблона;
screenshot_url - ссылка на скриншот шаблона;
fullsize_screenshot_url - возвращает ссылку на полноразмерное изображение системного шаблона;
created - дата и время создания шаблона UTC;
updated - дата и время обновления шаблона UTC;
type - тип шаблона (системный/пользовательский);
body - тело шаблона;
raw_body - системный параметр, содержащий json-структуру данных блочного редактора;
message_format - возвращает способ создания шаблона: "block" - блочный редактор, "raw_html" - html редактор.
Формат ошибок:
{
{"error":"VK151214-01 [ 'date_from' value is not a valid datetime "2015-12-14 12:5x"]"}
{"error":"VK151214-01 [ 'date_to' value is not a valid datetime "2015-12-14 22:0x"]"}
{"error":"VK151214-01 [ 'limit' value should be a valid number]"}
{"error":"VK151214-01 [ 'offset' value should be greater than or equal to 0]"}
}