tasks.api.scrum.kanban.addTask
Добавить задачу в канбан Скрама
Описание
Метод добавляет задачу в канбан Скрама.
Параметры
sprintId
integer
обязательный
Идентификатор спринта. Получить идентификатор можно при помощи метода tasks.api.scrum.sprint.list
taskId
integer
обязательный
Идентификатор задачи. Получить идентификатор можно при помощи метода tasks.task.list
stageId
integer
обязательный
Идентификатор стадии. Получить идентификатор можно при помощи метода tasks.api.scrum.kanban.getStages
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"sprintId":5,"taskId":751,"stageId":58}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.api.scrum.kanban.addTask
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"sprintId":5,"taskId":751,"stageId":58,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/tasks.api.scrum.kanban.addTask
// 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
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'tasks.api.scrum.kanban.addTask',
params: {
sprintId: 5,
taskId: 751,
stageId: 58,
},
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('Task added to kanban:', 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 addTaskToKanban() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'tasks.api.scrum.kanban.addTask',
params: {
sprintId: 5,
taskId: 751,
stageId: 58,
},
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('Task added to kanban:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', addTaskToKanban)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.tasks.api.scrum.kanban.add_task(
sprint_id=5,
task_id=751,
stage_id=58,
).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.api.scrum.kanban.addTask',
[
'sprintId' => 5,
'taskId' => 751,
'stageId' => 58,
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
// Нужная вам логика обработки данных
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error adding task: ' . $e->getMessage();
}
BX24.callMethod(
'tasks.api.scrum.kanban.addTask',
{
"sprintId": 5,
"taskId": 751,
"stageId": 58,
},
function(result) {
if (result.error()) {
console.error(result.error());
} else {
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'tasks.api.scrum.kanban.addTask',
[
'sprintId' => 5,
'taskId' => 751,
'stageId' => 58
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "tasks.api.scrum.kanban.addTask", b24.Params{
"sprintId": 5,
"taskId": 751,
"stageId": 58,
})
if err != nil {
return fmt.Errorf("tasks.api.scrum.kanban.addTask: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time":{
"start":1712137817.343984,
"finish":1712137817.605804,
"duration":0.26182007789611816,
"processing":0.018325090408325195,
"date_start":"2024-04-03T12:50:17+03:00",
"date_finish":"2024-04-03T12:50:17+03:00"
}
}
Обработка ошибок
HTTP-статус: 400
{
"error":0,
"error_description":"TaskId id not found"
}
| Код | Описание | Значение |
|---|---|---|
0 |
Sprint id not found |
Не заполнено обязательное поле sprintId |
0 |
TaskId id not found |
Не заполнено обязательное поле taskId |
0 |
StageId id not found |
Не заполнено обязательное поле stageId |
0 |
Sprint not found |
Передан неизвестный идентификатор спринта |
0 |
Stage not found |
Передан неизвестный идентификатор стадии |
0 |
Task not found. The task must be with GROUP_ID |
Передан неизвестный идентификатор задачи или задача не принадлежит группе спринта |
0 |
Access denied |
Доступ запрещен |
0 |
Неизвестная ошибка |

