tasks.template.get
Получить шаблон задачи по идентификатору
Описание
Метод tasks.template.get возвращает данные шаблона задачи по идентификатору.
Параметры
templateId
integer
обязательный
Идентификатор шаблона задачи.
Идентификатор шаблона задачи можно получить при создании нового шаблона
params
object
необязательный
Дополнительные параметры выборки (подробное описание)
Параметр params
select
array
необязательный
Массив полей, которые нужно вернуть.
По умолчанию используются ['*', 'UF_*'] — выбрать все поля и пользовательские поля
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"templateId": 139
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.template.get
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"templateId": 139,
"auth": "**put_access_token_here**"
}' \
https://**put_your_bitrix24_address**/rest/tasks.template.get
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type TaskTemplateResult = {
ID: string
TITLE: string
DESCRIPTION: string
RESPONSIBLE_ID: string
CREATED_BY: string
REPLICATE: string
STATUS: string
}
try {
const response = await $b24.actions.v2.call.make<TaskTemplateResult>({
method: 'tasks.template.get',
params: {
templateId: 139,
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info(result.ID, result.TITLE, result.RESPONSIBLE_ID)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function getTaskTemplate() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'tasks.template.get',
params: {
templateId: 139,
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info(result.ID, result.TITLE, result.RESPONSIBLE_ID)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', getTaskTemplate)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.tasks.template.get(template_id=139).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'tasks.template.get',
[
'templateId' => 139
]
);
$result = $response
->getResponseData()
->getResult();
print_r($result);
} catch (Throwable $e) {
echo 'Ошибка получения шаблона: ' . $e->getMessage();
}
BX24.callMethod(
'tasks.template.get',
{
templateId: 139
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.log(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'tasks.template.get',
[
'templateId' => 139
]
);
print_r($result);
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "tasks.template.get", b24.Params{
"templateId": 139,
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("tasks.template.get: %w", err)
}
var item struct {
ID b24.ID `json:"ID"`
Title string `json:"TITLE"`
Description string `json:"DESCRIPTION"`
DescriptionInBbcode string `json:"DESCRIPTION_IN_BBCODE"`
Priority string `json:"PRIORITY"`
Status string `json:"STATUS"`
}
if err := json.Unmarshal(res.Result, &item); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.ID, item.Title)
Ответ
HTTP-статус: 200
{
"result": {
"ID": "139",
"TITLE": "Подготовка еженедельного статуса по проекту",
"DESCRIPTION": "Шаблон задачи для подготовки и согласования еженедельного статуса по проекту с командой и руководителем",
"DESCRIPTION_IN_BBCODE": "Y",
"PRIORITY": "2",
"STATUS": "1",
"STAGE_ID": "0",
"RESPONSIBLE_ID": "102",
"DEADLINE_AFTER": null,
"START_DATE_PLAN_AFTER": "32400",
"END_DATE_PLAN_AFTER": "97200",
"REPLICATE": "Y",
"CREATED_BY": "101",
"XML_ID": null,
"ALLOW_CHANGE_DEADLINE": "Y",
"ALLOW_TIME_TRACKING": "Y",
"TASK_CONTROL": "N",
"ADD_IN_REPORT": "N",
"GROUP_ID": "0",
"PARENT_ID": "8131",
"MULTITASK": "N",
"SITE_ID": "s1",
"ACCOMPLICES": "a:0:{}",
"AUDITORS": "a:0:{}",
"RESPONSIBLES": "a:1:{i:0;s:3:\"102\";}",
"FILES": null,
"TAGS": null,
"DEPENDS_ON": null,
"MATCH_WORK_TIME": "Y",
"TASK_ID": null,
"TPARAM_TYPE": "0",
"TPARAM_REPLICATION_COUNT": "0",
"REPLICATE_PARAMS": "a:19:{s:6:\"PERIOD\";s:6:\"weekly\";s:12:\"WORKDAY_ONLY\";s:1:\"N\";s:9:\"WEEK_DAYS\";a:1:{i:0;i:2;}s:4:\"TIME\";s:5:\"11:00\";s:15:\"TIMEZONE_OFFSET\";i:0;s:11:\"REPEAT_TILL\";s:7:\"endless\";s:10:\"START_DATE\";s:19:\"16.03.2026 00:00:00\";s:9:\"EVERY_DAY\";i:1;s:10:\"EVERY_WEEK\";i:1;s:15:\"MONTHLY_DAY_NUM\";i:1;s:19:\"MONTHLY_MONTH_NUM_1\";i:1;s:19:\"MONTHLY_MONTH_NUM_2\";i:1;s:14:\"YEARLY_DAY_NUM\";i:1;s:8:\"END_DATE\";N;s:12:\"MONTHLY_TYPE\";i:1;s:11:\"YEARLY_TYPE\";i:1;s:14:\"DEADLINE_AFTER\";i:0;s:15:\"DEADLINE_OFFSET\";i:0;s:19:\"NEXT_EXECUTION_TIME\";s:19:\"17.03.2026 11:00:00\";}",
"BASE_TEMPLATE_ID": "0",
"TEMPLATE_CHILDREN_COUNT": "0",
"CREATED_BY_NAME": "Иван",
"CREATED_BY_LAST_NAME": "Иванов",
"CREATED_BY_SECOND_NAME": "Иванович",
"CREATED_BY_LOGIN": "ivan.ivanov@example.ru",
"CREATED_BY_WORK_POSITION": "Сотрудник",
"CREATED_BY_PHOTO": "10001",
"RESPONSIBLE_NAME": "Петр",
"RESPONSIBLE_LAST_NAME": "Петров",
"RESPONSIBLE_SECOND_NAME": "Петрович",
"RESPONSIBLE_LOGIN": "petr.petrov@example.ru",
"RESPONSIBLE_WORK_POSITION": "Сотрудник",
"RESPONSIBLE_PHOTO": "10002",
"SCENARIO": "default",
"UF_CRM_TASK": [
"L_1179",
"D_1833"
],
"UF_TASK_WEBDAV_FILES": [
1117
]
},
"time": {
"start": 1773219184,
"finish": 1773219184.579376,
"duration": 0.5793759822845459,
"processing": 0,
"date_start": "2026-03-11T11:53:04+03:00",
"date_finish": "2026-03-11T11:53:04+03:00",
"operating_reset_at": 1773219784,
"operating": 0
}
}
Возвращаемые данные
result
object
Данные шаблона задачи (подробное описание).
Возвращает false:
- если templateId передан пустым
- шаблона с указанным templateId не существует
- у пользователя нет прав на просмотр шаблона
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "100",
"error_description": "Could not find value for parameter {templateId}"
}
| Код | Описание | Значение |
|---|---|---|
400 |
100 |
Could not find value for parameter {templateId} |

