Документация для разработчиков

disk.folder.uploadfile

disk.folder.uploadfile

Загружает новый файл в указанную папку.

В случае успеха возвращает структуру, аналогичную disk.file.get.

Параметры

Параметр Описание
id Идентификатор папки.
fileContent Аналогично 'DETAIL_PICTURE' в примере Обработка файлов.
data Массив, описывающий файл. Обязательное поле NAME - имя нового файла.

Пример

BX24.callMethod(
		"disk.folder.uploadfile",
		{
			id: 4,
			data: {
				NAME: "avatar.jpg"
			},
			fileContent: document.getElementById('test_file_input')
		},
		function (result)
		{
			if (result.error())
				console.error(result.error());
			else
				console.dir(result.data());
		}
);

Пример прямой загрузки файла на Диск

  1. Первым делом вызываем /rest/disk.folder.uploadFile и передаем методу только ID папки:
  2. disk.folder.uploadFile?auth=n2423m863oil59f99c9g0bm4918l5erz&id=289
    
  3. В ответ получаем параметр UploadUrl и параметр field:
  4. "result": {
            "field": "file",  
            "uploadUrl": "http://b24.sigurd.bx/rest/upload.json?auth=n2423m863oil59f99c9g0bm4918l5erz&token=disk%7CaWQ9Mjg5Jl89QkYzazEzaXNnUjNHcVZQcDJZaGxGRmI4TGhXOG5EZXQ%3D%7CInVwbG9hZHxkaXNrfGFXUTlNamc1Smw4OVFrWXphekV6YVhOblVqTkhjV
    lpRY0RKWmFHeEdSbUk0VEdoWE9HNUVaWFE9fG4yNDIzbTg2M29pbDU5Zjk5YzlnMGJtNDkxOGw1ZXJ6Ig%3D%3D.Aga709nyY0%2BrFiv3laHjfg6XuOO5JT6ttjU%2F53ifphM%3D"
        }
    
  5. На полученный UploadUrl посылаем POST-запрос в multipart/form-data, в котором передаем файл в поле с именем, полученном в параметре field:
  6. http --form POST "http://b24.sigurd.bx/rest/upload.json?auth=n2423m863oil59f99c9g0bm4918l5erz&token=disk%7CaWQ9Mjg5Jl89QkYzazEzaXNnUjNHcVZQcDJZaGxGRmI4TGhXOG5EZXQ%3D%7CInVwbG9hZHxkaXNrfGFXUTlNamc1Smw4OVFrWXp
    hekV6YVhOblVqTkhjVlpRY0RKWmFHeEdSbUk0VEdoWE9HNUVaWFE9fG4yNDIzbTg2M29pbDU5Zjk5YzlnMGJtNDkxOGw1ZXJ6Ig%3D%3D.Aga709nyY0%2BrFiv3laHjfg6XuOO5JT6ttjU%2F53ifphM%3D" file@~/somelongfile.log
    
  7. В ответ получаем данные о загруженном файле:
  8. "result": {
            "CODE": null,  
            "CREATED_BY": "1",  
            "CREATE_TIME": "2016-03-30T14:30:41+02:00",  
            "DELETED_BY": null,  
            "DELETED_TYPE": 0,  
            "DELETE_TIME": null,  
            "DETAIL_URL": "http://b24.sigurd.bx/company/personal/user/1/disk/file/Тестируем REST/somelongfile.log",  
            "DOWNLOAD_URL": "http://b24.sigurd.bx/rest/download.json?auth=n2423m863oil59f99c9g0bm4918l5erz&token=disk%7CaWQ9MjkwJl89ZTI4MG9TcDZCQno2MDAwVmV3cnRkbWxLM2hLN0JweEs%3D%7CImRvd25sb2FkfGRpc2t8YVdROU1qa3dKbDg5WlRJNE1HOVRjRFpD
    UW5vMk1EQXdWbVYzY25Sa2JXeExNMmhMTjBKd2VFcz18bjI0MjNtODYzb2lsNTlmOTljOWcwYm00OTE4bDVlcnoi.QlpUpx4mG9sxeyMyholPfdgkoXgc9kK9gtbOagqSo7s%3D",
            "FILE_ID": 209,  
            "GLOBAL_CONTENT_VERSION": 1,  
            "ID": 290,  
            "NAME": "somelongfile.log",  
            "PARENT_ID": "289",  
            "SIZE": "496136787",  
            "STORAGE_ID": "1",  
            "TYPE": "file",  
            "UPDATED_BY": "1",  
            "UPDATE_TIME": "2016-03-30T14:30:43+02:00"
        }
    


© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх