Общие сведения
Для получения содержимого объектного или файлового хранилища данных используется операция Download.
В описаниях запросов, приведенных ниже, параметр baseURL это адрес публикации HTTP-сервиса ПередачаДанных в информационной базе, к которой происходит обращение. Например, a/sbm/hs/dt.
Для вызова операции Download пользователю, от имени которого происходит обращение к HTTP-сервису, должна быль назначена роль УдаленныйДоступ.
Получение содержимого объектного хранилища
Запрос
|
Параметры URL
Параметр URL | Допустимое значение | Описание |
|---|---|---|
| Storage | Произвольное | Имя объектного хранилища, данные из которого необходимо получить. |
| ID | Определяется хранилищем | Идентификатор данных, которые необходимо получить из объектного хранилища. |
Заголовки
Имя | Значение | Описание |
|---|---|---|
| IBSession | start | Система 1С:Предприятие создает новый сеанс, выполняет аутентификацию, устанавливает разделители, выполняются все необходимые обработчики событий. Если система не может создать новый сеанс, то клиент получит ошибку 406 Not Acceptable. Если создание сеанса выполнено успешно, в HTTP-ответ помещается директива установить cookie ibsession с идентификатором созданного сеанса: Set-Cookie: ibsession=<ID сеанса>. Если требуется использовать ранее созданный сеанс, в HTTP-запросе к системе 1С:Предприятие необходимо указать идентификатор ранее созданного сеанса: Cookie: ibsession=<ID сеанса>. Если в запросе указывается идентификатор сеанса, который ранее не создавался или был завершен, клиент получает ошибку 400 Bad Request. Если в HTTP-запрос не содержит заголовка IBSession, то сеанс создается и завершается при каждом вызове интернет-сервиса. Если в процессе использования сеанса в HTTP-запросе изменяются значения разделителей или безопасный режим сеанса, то новые параметры игнорируются и сеанс будет использовать те значения, которые были указаны при старте сеанса. |
| IBSession | finish | Система 1С:Предприятие завершает сеанс, который указан в запросе, одновременно с командой завершения сеанса: Cookie: ibsession=<ID сеанса>. Завершение сеанса произойдет автоматически, если в этом сеансе не выполнялось никаких действий за время жизни сеанса. |
Тело запроса
Данный запрос не требует заполнения тела запроса. Переданная в теле запроса информация игнорируется.
Коды состояния
Код состояния | Представление | Описание |
|---|---|---|
| 302 | Found | Данные с идентификатором {ID} найдены в объектном хранилище {Storage}. |
| 400 | Bad Request | Сеанс не создавался или был завершен. |
| 404 | Not Found | Данные с идентификатором {ID} не найдены в объектном хранилище {Storage}. |
| 406 | Not Acceptable | Не удалось создать новый сеанс. |
| 415 | Unsupported Media Type | Объектное хранилище с именем {Storage} не поддерживается. |
Пример
Запрос
|
Получение содержимого файлового хранилища
|
Параметры URL
Параметр URL | Допустимое значение | Описание |
|---|---|---|
| VolumeID | Произвольное | Идентификатор файлового хранилища, данные которого необходимо получить данные. |
| * | Произвольное | Относительное имя файла с путем в файловом хранилище. |
Заголовки
Имя | Значение | Описание |
|---|---|---|
| IBSession | start | Система «1С:Предприятие» создает новый сеанс, выполняет аутентификацию, устанавливает разделители, выполняются все необходимые обработчики событий. Если система не может создать новый сеанс, то клиент получит ошибку 406 Not Acceptable. Если создание сеанса выполнено успешно, в HTTP-ответ помещается директива установить cookie ibsession с идентификатором созданного сеанса: Set-Cookie: ibsession=<ID сеанса>. При требуется использовать ранее созданный сеанс, в HTTP-запросе к системе «1С:Предприятие» необходимо указать идентификатор ранее созданного сеанса: Cookie: ibsession=<ID сеанса>. Если в запросе указывается идентификатор сеанса, который ранее не создавался или был завершен, клиент получает ошибку 400 Bad Request. Если в HTTP-запрос не содержит заголовка IBSession, то сеанс создается и завершается при каждом вызове интернет-сервиса. Если в процессе использования сеанса в HTTP-запросе изменяются значения разделителей или безопасный режим сеанса, то новые параметры игнорируются и сеанс будет использовать те значения, которые были указаны при старте сеанса. |
| IBSession | finish | Система "1С:Предприятие" завершает сеанс, который указан в запросе, одновременно с командой завершения сеанса: Cookie: ibsession=<ID сеанса>. Завершение сеанса произойдет автоматически, если в этом сеансе не выполнялось никаких действий за время жизни сеанса. |
Тело запроса
Данный запрос не требует заполнения тела запроса. Переданная в теле запроса информация игнорируется.
Коды состояния
Код состояния | Представление | Описание |
|---|---|---|
| 302 | Found | Данные по пути {*} найдены в файловом хранилище {VolumeID}. |
| 400 | Bad Request | Сеанс не создавался или был завершен. |
| 404 | Not Found | Данные по пути {*} не найдены в хранилище {VolumeID}. |
| 406 | Not Acceptable | Не удалось создать новый сеанс. |
| 415 | Unsupported Media Type | Файловое хранилище с идентификатором {VolumeID} не поддерживается. |
Пример
Пример запроса
|
HTTP-ответ
Возвращает 302 Found, перенаправляющий на адрес получения данных. Для получения данных необходимо перейти по адресу, полученному из поля Location заголовка ответа.
Адрес для скачивания является временным и срок использования ограничен.
Пример ответа
|
Получение диапазона
Чтобы получить часть данных необходимо использовать HTTP-заголовок Range в соответствии с RFC 2616.
Обратите внимание, что заголовок Range необходимо добавить к HTTP-запросу после получения перенаправления 302 Found.
Пример запроса
|
Возвращает 206 Partial Content с запрошенным диапазоном данных.
Если диапазон не может быть получен, заголовок Range будет проигнорирован, и будет получен ответ 200 Success с полным содержимым данных.
Пример ответа
|