Как обновить и удалить файлы

В Битрикс24 есть два типа файловых полей.

  • Файл. Поле не связано с Диском, в него файлы загружаются напрямую через строку формата Base64. После загрузки в поле хранится ID файла.

  • Файл (диск). Поле связано с Диском, в поле хранится ID объекта диска. Поле не обрабатывает формат Base64. Для обновления файлов диска используйте методы disk.file.*.

Как обновить файл

Если поле не множественное, загрузите новый файл в поле методом *.update. Используйте формат передачи данных Base64. При загрузке нового файла старый файл удалится автоматически.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"ID":525,"FIELDS":{"TEMPLATE_DATA":["bp-379.bpt","base64_encoded_content_here"]}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/bizproc.workflow.template.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"ID":525,"FIELDS":{"TEMPLATE_DATA":["bp-379.bpt","base64_encoded_content_here"]},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/bizproc.workflow.template.update
        
try
        {
        	const response = await $b24.callMethod(
        		'bizproc.workflow.template.update',
        		{
        			ID: 525,
        			FIELDS: {
        				// Контент файла с новым шаблоном бизнес-процесса
        				TEMPLATE_DATA: [
        					"bp-379.bpt", // Первый элемент массива - имя файла
        					"base64_encoded_content_here" // Второй элемент массива - контент файла, закодированный в base64
        				]
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        	// Необходимая логика обработки результата
        	processResult(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'bizproc.workflow.template.update',
                    [
                        'ID'     => 525,
                        'FIELDS' => [
                            'TEMPLATE_DATA' => [
                                "bp-379.bpt", // Первый элемент массива - имя файла
                                "base64_encoded_content_here" // Второй элемент массива - контент файла, закодированный в base64
                            ]
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating workflow template: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'bizproc.workflow.template.update',
            {
                ID: 525,
                FIELDS: {
                    // Контент файла с новым шаблоном бизнес-процесса
                    TEMPLATE_DATA: [
                        "bp-379.bpt", // Первый элемент массива - имя файла
                        "base64_encoded_content_here" // Второй элемент массива - контент файла, закодированный в base64
                    ]
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'bizproc.workflow.template.update',
            [
                'ID' => 525,
                'FIELDS' => [
                    'TEMPLATE_DATA' => [
                        'bp-379.bpt',
                        'base64_encoded_content_here'
                    ]
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Чтобы очистить поле, передайте пустое значение.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":9,"entityTypeId":177,"fields":{"ufCrm_7_1739432938":[]}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":9,"entityTypeId":177,"fields":{"ufCrm_7_1739432938":[]},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/crm.item.update
        
try
        {
        	const response = await $b24.callMethod(
        		"crm.item.update",
        		{
        			id: 9,
        			entityTypeId: 177,
        			fields: {
        				ufCrm_7_1739432938: [ // пустое значение для удаления файла из поля
        				]
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.item.update',
                    [
                        'id'           => 9,
                        'entityTypeId' => 177,
                        'fields'       => [
                            'ufCrm_7_1739432938' => [], // пустое значение для удаления файла из поля
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating CRM item: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "crm.item.update",
            {
                id: 9,
                entityTypeId: 177,
                fields: {
                    ufCrm_7_1739432938: [ // пустое значение для удаления файла из поля
                    ]
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.update',
            [
                'id' => 9,
                'entityTypeId' => 177,
                'fields' => [
                    'ufCrm_7_1739432938' => []
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Обновить файл во множественном поле

Если поле множественное, в поле хранится массив из ID файлов. При обновлении множественных полей типа «файл» учитывайте особенности методов.

crm.item.update — обновить поле в объекте CRM

Для обновления полей в объектах CRM используйте универсальный метод crm.item.update.

Не рекомендуется использовать методы crm.deal.update, crm.lead.update, crm.contact.update, crm.company.update для обновления файловых полей.

1. Получить ID файлов в поле

Перед обновлением поля получите ID текущих файлов, чтобы сохранить их. Можно использовать метод crm.item.get, он вернет все поля элемента, или метод crm.item.list с выбором только нужного поля типа «файл» в select.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"entityTypeId":177,"select":["ufCrm_7_1739432938"],"filter":{"id":"29"}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.list
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"entityTypeId":177,"select":["ufCrm_7_1739432938"],"filter":{"id":"29"},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/crm.item.list
        
// callListMethod: Получает все данные сразу. Используйте только для небольших выборок (< 1000 элементов) из-за высокой нагрузки на память.
        
        try {
          const response = await $b24.callListMethod(
            'crm.item.list',
            {
              entityTypeId: 177,
              select: [
                "ufCrm_7_1739432938", // поле типа «файл»
              ],
              filter: {
                "id": "29",
              },
            },
            (progress) => { console.log('Progress:', progress) }
          )
          const items = response.getData() || []
          for (const entity of items) { console.log('Entity:', entity) }
        } catch (error) {
          console.error('Request failed', error)
        }
        
        // fetchListMethod: Выбирает данные по частям с помощью итератора. Используйте для больших объемов данных для эффективного потребления памяти.
        
        try {
          const generator = $b24.fetchListMethod('crm.item.list', { entityTypeId: 177, select: ["ufCrm_7_1739432938"], filter: { "id": "29" } }, 'ID')
          for await (const page of generator) {
            for (const entity of page) { console.log('Entity:', entity) }
          }
        } catch (error) {
          console.error('Request failed', error)
        }
        
        // callMethod: Ручное управление постраничной навигацией через параметр start. Используйте для точного контроля над пакетами запросов. Для больших данных менее эффективен, чем fetchListMethod.
        
        try {
          const response = await $b24.callMethod('crm.item.list', { entityTypeId: 177, select: ["ufCrm_7_1739432938"], filter: { "id": "29" } }, 0)
          const result = response.getData().result || []
          for (const entity of result) { console.log('Entity:', entity) }
        } catch (error) {
          console.error('Request failed', error)
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.item.list',
                    [
                        'entityTypeId' => 177,
                        'select' => [
                            "ufCrm_7_1739432938", // поле типа «файл»
                        ],
                        'filter' => [
                            "id" => "29",
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error fetching CRM items: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'crm.item.list',
            {
                entityTypeId: 177,
                select: [
                    "ufCrm_7_1739432938", // поле типа «файл»
                ],
                filter: {
                    "id": "29",
                },
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.list',
            [
                'entityTypeId' => 177,
                'select' => [
                    'ufCrm_7_1739432938' // поле типа «файл»
                ],
                'filter' => [
                    'id' => '29'
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

В ответе получим информацию по файлам: ID и ссылки на скачивание.

{
            "result": {
                "items": [
                    {
                        "ufCrm_7_1739432938": [
                            {
                                "id": 30577, // id файла, используем для сохранения файла в поле
                                "url": "https://your-domain.bitrix24.com/bitrix/services/main/ajax.php?action=crm.controller.item.getFile&SITE_ID=s1&entityTypeId=177&id=29&fieldName=UF_CRM_7_1739432938&fileId=30577",
                                "urlMachine": "https://your-domain.bitrix24.com/rest/crm.controller.item.getFile.json?auth=c2a8ad670000071b006e2cf200000001f0f107061147e530dda74d4e556cae7642992c&token=crm%7CYWN0aW9uPWNybS5jb25ZTU1NmNhZTc2NDI5OTJjIg%3D%3D.cR012fYj2JpQSObAORU0G8ZDvVc1Osnv0foUpBpaJVY%3D"
                            },
                            {
                                "id": 30581, // id файла, используем для сохранения файла в поле
                                "url": "https:///your-domain.bitrix24.com/bitrix/services/main/ajax.php?action=crm.controller.item.getFile&SITE_ID=s1&entityTypeId=177&id=29&fieldName=UF_CRM_7_1739432938&fileId=30581",
                                "urlMachine": "https:///your-domain.bitrix24.com/rest/crm.controller.item.getFile.json?auth=c2a8ad670000071b006e2cf200000001f0f107061147e530dda74d4e556cae7642992c&token=crm%7CYWNNmNhZTc2NDI5OTJjIg%3D%3D.l6GB1qKENuwQYtQHse4GK1r%2F3zps%2FQdh%2BlFsopOuJdU%3D"
                            }
                        ]
                    }
                ]
            },
        }

2. Обновить файлы в поле

В зависимости от переданных параметров метод crm.item.update выполняет операции:

  • загрузки новых файлов — передавайте контент в формате Bаse64,

  • удаления старых файлов — не передавайте ID этих файлов в массиве,

  • сохранения файлов — передавайте ID в массиве файлов.

Файлы будут сохранены, если их ID перечислены в запросе. Файлы будут удалены, если их ID отсутствует в запросе.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":9,"entityTypeId":177,"fields":{"ufCrm_7_1739432938":[{"id":30577},["myNewFile.pdf","base64_encoded_content_here"]]}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":9,"entityTypeId":177,"fields":{"ufCrm_7_1739432938":[{"id":30577},["myNewFile.pdf","base64_encoded_content_here"]]},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/crm.item.update
        
try
        {
        	const response = await $b24.callMethod(
        		"crm.item.update",
        		{
        			id: 9,
        			entityTypeId: 177,
        			fields: {
        				ufCrm_7_1739432938: [
        					{
        						id: 30577 // id старого файла, который будет сохранен в поле
        					},
        					[
        						"myNewFile.pdf", // Имя нового файла
        						"base64_encoded_content_here" // Контент нового файла в формате base64
        					]
        				]
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        	// Необходимая логика обработки данных
        	processResult(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.item.update',
                    [
                        'id'           => 9,
                        'entityTypeId' => 177,
                        'fields'       => [
                            'ufCrm_7_1739432938' => [
                                [
                                    'id' => 30577 // id старого файла, который будет сохранен в поле
                                ],
                                [
                                    'myNewFile.pdf', // Имя нового файла
                                    'base64_encoded_content_here' // Контент нового файла в формате base64
                                ]
                            ]
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating CRM item: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "crm.item.update",
            {
                id: 9,
                entityTypeId: 177,
                fields: {
                    ufCrm_7_1739432938: [
                        {
                            id: 30577 // id старого файла, который будет сохранен в поле
                        },
                        [
                            "myNewFile.pdf", // Имя нового файла
                            "base64_encoded_content_here" // Контент нового файла в формате base64
                        ]
                    ]
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'crm.item.update',
            [
                'id' => 9,
                'entityTypeId' => 177,
                'fields' => [
                    'ufCrm_7_1739432938' => [
                        [
                            'id' => 30577 // id старого файла, который будет сохранен в поле
                        ],
                        [
                            'myNewFile.pdf', // Имя нового файла
                            'base64_encoded_content_here' // Контент нового файла в формате base64
                        ]
                    ]
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Чтобы удалить все файлы, передавайте пустой массив в поле.

crm.timeline.comment.update — обновить файлы в комментарии

Для обновления файлов в комментариях элементов CRM используйте метод crm.timeline.comment.update. Старые файлы всегда удаляются при обновлении значения поля. Новые файлы загружайте в поле в формате Base64.

Чтобы удалить все файлы, передавайте пустой массив в поле FILES.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":62589,"fields":{"COMMENT":"Comment was changed","FILES":[]}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.timeline.comment.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":62589,"fields":{"COMMENT":"Comment was changed","FILES":[]},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/crm.timeline.comment.update
        
try
        {
        	const response = await $b24.callMethod(
        		'crm.timeline.comment.update',
        		{
        			id: 62589,
        			fields: {
        				"COMMENT": "Comment was changed",
        				"FILES": [ // пустое значение для удаления файлов
        				]
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.timeline.comment.update',
                    [
                        'id' => 62589,
                        'fields' => [
                            'COMMENT' => 'Comment was changed',
                            'FILES' => [], // пустое значение для удаления файлов
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating timeline comment: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "crm.timeline.comment.update",
            {
                id: 62589,
                fields: {
                    "COMMENT": "Comment was changed",
                    "FILES": [ // пустое значение для удаления файлов
                    ]
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'crm.timeline.comment.update',
            [
                'id' => 62589,
                'fields' => [
                    'COMMENT' => 'Comment was changed',
                    'FILES' => [] // пустое значение для удаления файлов
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

lists.element.update — обновить поле в списке

Чтобы загрузить новые файлы в поле элемента списка, передавайте файлы методом lists.element.update в формате Base64. Старые файлы останутся в поле без изменений.

Для удаления файлов понадобится ID значения свойства.

1. Получить ID значения свойства

Чтобы получить ID для удаления файла, выполните метод lists.element.get, он вернет все поля элемента.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":"37","ELEMENT_ID":"6783"}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.get
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":"37","ELEMENT_ID":"6783","auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/lists.element.get
        
try
        {
        	const response = await $b24.callMethod(
        		'lists.element.get',
        		{
        			IBLOCK_TYPE_ID: 'lists',
        			IBLOCK_ID: '37',
        			ELEMENT_ID: '6783'
        		}
        	);
        	
        	const result = response.getData().result;
        	// Нужная вам логика обработки данных
        	processResult(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'lists.element.get',
                    [
                        'IBLOCK_TYPE_ID' => 'lists',
                        'IBLOCK_ID'      => '37',
                        'ELEMENT_ID'     => '6783',
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting list element: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'lists.element.get',
            {
                IBLOCK_TYPE_ID: 'lists',
                IBLOCK_ID: '37',
                ELEMENT_ID: '6783'
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'lists.element.get',
            [
                'IBLOCK_TYPE_ID' => 'lists',
                'IBLOCK_ID' => '37',
                'ELEMENT_ID' => '6783'
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Поле «файл» в примере — PROPERTY_1075. В поле получим информацию:

  • первое значение "3693" — это ID значения свойства,

  • второе значение "31219"— это ID файла.

{
            "result": [
                {
                    "ID": "6783",
                    "PROPERTY_1075": {
                        "3693": "31219", // 3693 — id значения, используем для удаления
                        "3697": "31221", // 3697 — id значения, используем для удаления
                        "3699": "31223"  // 3699 — id значения, используем для удаления
                    }
                }
            ],
            "total": 1,
        }

2. Удалить файл из поля

Передайте в метод lists.element.update поле с постфиксом _DEL, например PROPERTY_1075_DEL. В поле укажите список из ID значений свойств, которые будут удалены:

  • ключ — ID значения свойства,

  • значение — Y.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":37,"ELEMENT_ID":6783,"FIELDS":{"NAME":"файлы реста","PROPERTY_1075_DEL":{"3693":"Y"}}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":37,"ELEMENT_ID":6783,"FIELDS":{"NAME":"файлы реста","PROPERTY_1075_DEL":{"3693":"Y"}},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/lists.element.update
        
try
        {
        	const response = await $b24.callMethod(
        		"lists.element.update",
        		{
        			IBLOCK_TYPE_ID: "lists",
        			IBLOCK_ID: 37,
        			ELEMENT_ID: 6783,
        			FIELDS: {
        				NAME: "файлы реста",
        				PROPERTY_1075_DEL: { // постфикс _DEL для операции удаления
        					3693: "Y" // список значений для удаления
        				}
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        	// Необходимая логика обработки данных
        	processResult(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'lists.element.update',
                    [
                        'IBLOCK_TYPE_ID' => 'lists',
                        'IBLOCK_ID'      => 37,
                        'ELEMENT_ID'     => 6783,
                        'FIELDS'         => [
                            'NAME'            => 'файлы реста',
                            'PROPERTY_1075_DEL' => [ // постфикс _DEL для операции удаления
                                3693 => 'Y' // список значений для удаления
                            ]
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating list element: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "lists.element.update",
            {
                IBLOCK_TYPE_ID: "lists",
                IBLOCK_ID: 37,
                ELEMENT_ID: 6783,
                FIELDS: {
                    NAME: "файлы реста",
                    PROPERTY_1075_DEL: { // постфикс _DEL для операции удаления
                        3693: "Y" // список значений для удаления
                    }
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'lists.element.update',
            [
                'IBLOCK_TYPE_ID' => 'lists',
                'IBLOCK_ID' => 37,
                'ELEMENT_ID' => 6783,
                'FIELDS' => [
                    'NAME' => 'файлы реста',
                    'PROPERTY_1075_DEL' => [
                        3693 => 'Y' // постфикс _DEL для операции удаления
                    ]
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

log.blogpost.update — обновить файлы в посте

Чтобы загрузить новые файлы к посту в ленте, передавайте файлы методом log.blogpost.update в формате Base64. Старые файлы останутся в посте без изменений.

Для удаления файлов понадобится их ID.

1. Получить ID файла в посте

Чтобы получить ID для удаления файла, выполните метод log.blogpost.get, он вернет все поля поста, включая FILES.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/log.blogpost.get
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211,"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/log.blogpost.get
        
try
        {
        	const response = await $b24.callMethod(
        		"log.blogpost.get",
        		{
        			POST_ID: 211
        		}
        	);
        	
        	const result = response.getData().result;
        	console.log(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'log.blogpost.get',
                    [
                        'POST_ID' => 211
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting blog post: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "log.blogpost.get",
            {
                POST_ID: 211
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'log.blogpost.get',
            [
                'POST_ID' => 211
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

В ответе получим массив объектов:

  • первое значение 0 — это порядковый ID файла в посте,

  • второе значение 437— это ID файла.

[FILES] => Array
            (
                [0] => 437 
                [1] => 439
                [2] => 441

2. Удалить файл из поста

Передайте в метод log.blogpost.update поле FILES. В поле укажите массив ID файлов, которые будут удалены:

  • ключ — ID файла,

  • значение — del.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211,"POST_TITLE":"Новый заголовок поста","FILES":{"445":"del"}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/log.blogpost.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211,"POST_TITLE":"Новый заголовок поста","FILES":{"445":"del"},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/log.blogpost.update
        
try
        {
        	const response = await $b24.callMethod(
        		"log.blogpost.update",
        		{
        			POST_ID: 211,
        			POST_TITLE: "Новый заголовок поста",
        			FILES: {
        				"445": "del" // id файлов для удаления
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'log.blogpost.update',
                    [
                        'POST_ID'    => 211,
                        'POST_TITLE' => 'Новый заголовок поста',
                        'FILES'      => [
                            '445' => 'del' // id файлов для удаления
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating blog post: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "log.blogpost.update",
            {
                POST_ID: 211,
                POST_TITLE: "Новый заголовок поста",
                FILES: {
                    "445": "del" // id файлов для удаления
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'log.blogpost.update',
            [
                'POST_ID' => 211,
                'POST_TITLE' => 'Новый заголовок поста',
                'FILES' => [
                    '445' => 'del' // id файлов для удаления
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Чтобы удалить все файлы из поста, передайте в метод log.blogpost.update поле UF_BLOG_POST_FILE. В значении поля укажите ["empty"].

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211,"POST_TITLE":"Новый заголовок поста","UF_BLOG_POST_FILE":["empty"]}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/log.blogpost.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"POST_ID":211,"POST_TITLE":"Новый заголовок поста","UF_BLOG_POST_FILE":["empty"],"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/log.blogpost.update
        
try
        {
        	const response = await $b24.callMethod(
        		"log.blogpost.update",
        		{
        			POST_ID: 211,
        			POST_TITLE: "Новый заголовок поста",
        			UF_BLOG_POST_FILE: ["empty"] // удаление всех файлов поста
        		}
        	);
        	
        	const result = response.getData().result;
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'log.blogpost.update',
                    [
                        'POST_ID'         => 211,
                        'POST_TITLE'      => 'Новый заголовок поста',
                        'UF_BLOG_POST_FILE' => ['empty'], // удаление всех файлов поста
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating blog post: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "log.blogpost.update",
            {
                POST_ID: 211,
                POST_TITLE: "Новый заголовок поста",
                UF_BLOG_POST_FILE: ["empty"] // удаление всех файлов поста
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'log.blogpost.update',
            [
                'POST_ID' => 211,
                'POST_TITLE' => 'Новый заголовок поста',
                'UF_BLOG_POST_FILE' => ['empty'] // удаление всех файлов поста
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

catalog.product.update — обновить поле в товаре

Чтобы загрузить новые файлы в карточку товара, передавайте файлы методом catalog.product.update в формате Base64. Старые файлы останутся в поле без изменений.

Для удаления файлов понадобится ID значения поля.

1. Получить ID значения поля

Чтобы получить ID для удаления файла, выполните метод catalog.product.get. Метод вернет все поля товара.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":541}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.product.get
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":541,"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/catalog.product.get
        
try
        {
        	const response = await $b24.callMethod(
        		'catalog.product.get',
        		{
        			'id': 541
        		}
        	);
        	
        	const result = response.getData().result;
        	console.log(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'catalog.product.get',
                    [
                        'id' => 541
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting product information: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'catalog.product.get',
            {
                'id': 541
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'catalog.product.get',
            [
                'id' => 541
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Поле «файл» в примере — property1077. Поле содержит массив объектов:

  • value — это информация по файлу: ID и ссылки на скачивание,

  • valueId — это ID значения поля.

{
            "result": {
                "product": {
                    "iblockId": 25,
                    "id": 541,
                    "property1077": [
                        {
                            "value": {
                                "id": "31251",
                                "url": "/rest/catalog.product.download?fields%5BfieldName%5D=property1077&fields%5BfileId%5D=31251&fields%5BproductId%5D=541",
                                "urlMachine": "/rest/catalog.product.download?fields%5BfieldName%5D=property1077&fields%5BfileId%5D=31251&fields%5BproductId%5D=541"
                            },
                            "valueId": "3705" // id значения, используем для удаления
                        },
                        {
                            "value": {
                                "id": "31253",
                                "url": "/rest/catalog.product.download?fields%5BfieldName%5D=property1077&fields%5BfileId%5D=31253&fields%5BproductId%5D=541",
                                "urlMachine": "/rest/catalog.product.download?fields%5BfieldName%5D=property1077&fields%5BfileId%5D=31253&fields%5BproductId%5D=541"
                            },
                            "valueId": "3707" // id значения, используем для удаления
                        }
                    ],
        
                }
            },
        }

2. Удалить файл из поля

Чтобы удалить файл, передайте в метод catalog.product.update поле со значениями:

  • value — укажите remove как ключ, Y как значение,

  • valueId — укажитеID значения поля, файл которого будет удален.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":541,"fields":{"property1077":[{"value":{"remove":"Y"},"valueId":"3705"}]}}' https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.product.update
        
curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"id":541,"fields":{"property1077":[{"value":{"remove":"Y"},"valueId":"3705"}]},"auth":"**put_access_token_here**"}' https://**put_your_bitrix24_address**/rest/catalog.product.update
        
try
        {
        	const response = await $b24.callMethod(
        		'catalog.product.update',
        		{
        			id: 541,
        			fields: {
        				property1077: [
        					{
        						"value": {
        							'remove': 'Y', // операция удаления файла
        						},
        						'valueId': '3705', // id значения для удаления
        					}
        				]
        			}
        		}
        	);
        	
        	const result = response.getData().result;
        	console.log('Updated product with ID:', result);
        	// Нужная вам логика обработки данных
        	processResult(result);
        }
        catch( error )
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'catalog.product.update',
                    [
                        'id' => 541,
                        'fields' => [
                            'property1077' => [
                                [
                                    'value' => [
                                        'remove' => 'Y', // операция удаления файла
                                    ],
                                    'valueId' => '3705', // id значения для удаления
                                ]
                            ]
                        ]
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
            // Нужная вам логика обработки данных
            processData($result);
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating product: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'catalog.product.update',
            {
                id: 541,
                fields: {
                    property1077: [
                        {
                            "value": {
                                'remove': 'Y', // операция удаления файла
                            },
                            'valueId': '3705', // id значения для удаления
                        }
                    ]
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'catalog.product.update',
            [
                'id' => 541,
                'fields' => [
                    'property1077' => [
                        [
                            'value' => [
                                'remove' => 'Y' // операция удаления файла
                            ],
                            'valueId' => '3705' // id значения для удаления
                        ]
                    ]
                ]
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';
Предыдущая
Как загрузить файлы
Следующая
Лимиты REST API