Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Добавить стадию канбана или «Моего плана» task.stages.add». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Добавить стадию канбана или «Моего плана» task.stages.add

> Scope: task
>
> Кто может выполнять метод:
> — любой пользователь для стадий «Моего плана»
> — любой пользователь с доступом к группе для стадий канбана

Метод добавляет стадию канбана или «Моего плана».

Параметры метода

Параметр fields

Примеры кода

• cURL (Webhook)

    curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
    "fields": {
        "TITLE": "Название стадии",
        "COLOR": "#FFAAEE",
        "AFTER_ID": 1,
        "ENTITY_ID": 1
    },
    "isAdmin": false
    }' \
    https://your-domain.bitrix24.com/rest/_USER_ID_/_CODE_/task.stages.add

• cURL (OAuth)

    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: YOUR_ACCESS_TOKEN" \
    -d '{
    "fields": {
        "TITLE": "Название стадии",
        "COLOR": "#FFAAEE",
        "AFTER_ID": 1,
        "ENTITY_ID": 1
    },
    "isAdmin": false
    }' \
    https://your-domain.bitrix24.com/rest/task.stages.add

• JS

    try
    {
    	const response = await $b24.callMethod(
    		'task.stages.add',
    		{
    			fields: {
    				TITLE: 'Название стадии',
    				COLOR: '#FFAAEE',
    				AFTER_ID: 1,
    				ENTITY_ID: 1
    			},
    			isAdmin: false,
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }

• PHP

    try {
        $response = $b24Service
            ->core
            ->call(
                'task.stages.add',
                [
                    'fields' => [
                        'TITLE'    => 'Название стадии',
                        'COLOR'    => '#FFAAEE',
                        'AFTER_ID' => 1,
                        'ENTITY_ID' => 1
                    ],
                    'isAdmin' => false,
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error adding task stage: ' . $e->getMessage();
    }

• BX24.js

    BX24.callMethod(
        'task.stages.add',
        {
            fields: {
                TITLE: 'Название стадии',
                COLOR: '#FFAAEE',
                AFTER_ID: 1,
                ENTITY_ID: 1
            },
            isAdmin: false,
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );

• PHP CRest

    require_once('crest.php'); // подключение CRest PHP SDK

    $fields = [
        "TITLE" => "Название стадии",
        "COLOR" => "#FFAAEE",
        "AFTER_ID" => 1,
        "ENTITY_ID" => 1
    ];

    // выполнение запроса к REST API
    $result = CRest::call(
        'task.stages.add',
        [
            'fields' => $fields,
            'isAdmin' => false
        ]
    );

    // Обработка ответа от Битрикс24
    if ($result['error']) {
        echo 'Error: '.$result['error_description'];
    } else {
        print_r($result['result']);
    }

Обработка ответа

HTTP-статус: 200

{
    "result": 1
}

Возвращаемые данные

Обработка ошибок

HTTP-статус: 400

{
    "error": "EMPTY_TITLE",
    "error_description": "Не указан заголовок стадии"
}

Возможные коды ошибок

• [](./index)
• [](./task-stages-update)
• [](./task-stages-get)
• [](./task-stages-can-move-task)
• [](./task-stages-move-task)
• [](./task-stages-delete)