метод REST
scope: task
Устаревший
task.item.add
Добавить задачу
Устаревший метод.
Развитие метода остановлено. Используйте tasks.task.add.
Описание
Метод task.item.add создает новую задачу. Возвращает идентификатор добавленной задачи. Доступны следующие поля.
Параметры
TASKDATA
array
необязательный
Массив полей данных по задаче (TITLE, DESCRIPTION и так далее)
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"TITLE":"created via REST API at **current_datetime_here**","RESPONSIBLE_ID":1,"DEADLINE":"2013-05-13T16:06:06+03:00"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.item.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"TITLE":"created via REST API at **current_datetime_here**","RESPONSIBLE_ID":1,"DEADLINE":"2013-05-13T16:06:06+03:00"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/task.item.add
// 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
// task.item.add returns the ID of the newly created task
// Shape of the payload returned in result (match the "response handling" section of the page)
type TaskItemAddResult = number
try {
const response = await $b24.actions.v2.call.make<TaskItemAddResult>({
method: 'task.item.add',
params: {
fields: {
TITLE: 'created via REST API at ' + new Date().toLocaleString(),
RESPONSIBLE_ID: 1,
DEADLINE: '2013-05-13T16:06:06+03:00',
},
},
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('New task ID:', result)
}
} 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 addTaskItem() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'task.item.add',
params: {
fields: {
TITLE: 'created via REST API at ' + new Date().toLocaleString(),
RESPONSIBLE_ID: 1,
DEADLINE: '2013-05-13T16:06:06+03:00',
},
},
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('New task ID:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', addTaskItem)
</script>
try {
$dt = new DateTime();
$response = $b24Service
->core
->call(
'task.item.add',
[
[
'TITLE' => 'created via REST API at ' . $dt->format('Y-m-d H:i:s'),
'RESPONSIBLE_ID' => 1,
'DEADLINE' => '2013-05-13T16:06:06+03:00',
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
// Нужная вам логика обработки данных
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error adding task item: ' . $e->getMessage();
}
var dt = new Date();
BX24.callMethod(
'task.item.add',
[{TITLE: 'created via REST API at ' + dt.toLocaleString(), RESPONSIBLE_ID: 1, DEADLINE: '2013-05-13T16:06:06+03:00'}],
function(result)
{
console.info(result.data());
console.log(result);
}
);
require_once('crest.php');
$dt = new DateTime();
$title = 'created via REST API at ' . $dt->format('Y-m-d H:i:s');
$result = CRest::call(
'task.item.add',
[
'fields' => [
'TITLE' => $title,
'RESPONSIBLE_ID' => 1,
'DEADLINE' => '2013-05-13T16:06:06+03:00'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';

