HTTP Сервисы: Путь к своему сервису. Часть 3

10.10.18

Разработка - Инструментарий разработчика

Продолжение статьи «HTTP Сервисы: Путь к своему сервису. Часть 2». В предыдущих частях мы использовали только Get, в этой части поговорим о других методах и длительных операциях.

Файлы

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование Скачано Купить файл
Расширение с рассмотренными примерами сервисов. (Под 8.3.12)
.cfe 31,34Kb ver:0.0.4
44 2 500 руб. Купить
Расширение с рассмотренными примерами сервисов. Без Длительных Операций (Под 8.3.10)
.cfe 26,81Kb ver:0.0.3
25 2 500 руб. Купить
Внешняя обработка созданная по ходу статьи (HTTP-сервисы часть3)
.epf 8,07Kb ver:0.1
55 2 500 руб. Купить

Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний

Оформите подписку на компанию для решения рабочих задач

Оформить подписку и скачать решение со скидкой

Вы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».

  • 0% комиссии — оплата напрямую исполнителю;
  • Исполнители любого масштаба — от отдельных специалистов до команд под проект;
  • Прямой обмен контактами между заказчиком и исполнителем;
  • Безопасная сделка — при необходимости;
  • Рейтинги, кейсы и прозрачная система откликов.

В первой части мы создали каркас для Get метода в расширении конфигурации. Во второй части мы поработали с OData и создали обработку, получающую через HTTP-Сервис используя метод Get данные сформированные при помощи СКД. В этой части поговорим про другие методы и БСП:Базовая функциональность\Длительные операции (при отсутствии БСП в Вашей конфигурации необходимо использовать фоновые задания).

В этой статье http-сервис будет в расширении конфигурации БСП 2.4.6.146 на платформе 8.3.10.2650 + IIS, а вот посылать запросы и получать ответы будем в БСП 3.0.1.231 на платформе 8.3.12.1595.

Начнем.

Какие методы можно добавить в HTTP-Сервис?

  • GET - Получение данных.
  • HEAD - Запрашивает ресурс так же, как и метод GET, но без тела ответа.
  • PUT - Изменение данных.
  • POST - Создания новой сущности на сервере.
  • DELETE - Удаления данных.
  • PATCH - Используется для частичного изменения ресурса.
  • MERGE - Предназначен для дифференциального изменения данных. Аналогичен методу PATCH, но является расширением от Microsoft.
  • OPTIONS - Предназначен для получения информации о способах работы с данным URI (доступные HTTP-методы, форматы представления и т.п.).
  • TRACE - Возвращает полученный запрос так, что клиент может увидеть, какую информацию промежуточные серверы добавляют или изменяют в запросе.
  • CONNECT - Преобразует соединение запроса в прозрачный TCP/IP-туннель, обычно чтобы содействовать установлению защищённого SSL-соединения через нешифрованный прокси.
  • ANY (Любой) - Указывает, что может быть использован любой HTTP-метод из перечисления HTTPМетод.
  • И команды для WebDAV(Web Distributed Authoring and Versioning) или просто DAV — набор расширений и дополнений к протоколу HTTP, поддерживающих совместную работу пользователей над редактированием файлов и управление файлами на удаленных веб-серверах. (Еще ссылка по WebDAV)
 
 WebDAV расширяет HTTP следующими командами:

Подробнее о методах можно почитать туттут и тут

Давайте обратим внимание на метод «ANY (Любой)» - Данный метод позволяет перехватывать любой метод и обрабатывать его.

В голову пришел небольшой эксперимент благодаря статье Отправка PUT запроса средствами 1С 8.3. Давайте создадим в нашем http-сервисе метод ANY и в цикле используя ВызватьHTTPМетод переберем методы (GET, HEAD, PUT, POST, DELETE, PATCH, MERGE, OPTIONS, TRACE, CONNECT), обращаясь с телом запроса и без. Будем возвращать информацию по запросу.

Для начала создадим Демо базу на основе БСП 2.4.6.146 (на платформе 8.3.10), добавим в нее расширении из предыдущей части, изменим Корневой URL на PAPI и добавим метод "Любой (ANY)".

Обратите внимание на заголовок "Content-Type" (Код обработчика PAPI_ALL). Данный заголовок содержит тип данных и служит для того чтобы можно было понять, что находится в запросе или ответе. Про возможные типы можно почитать тут. мы укажем "text/plain; charset=utf-8" - текстовые данные.

 
 Код обработчика PAPI_ALL

Шаблон у нас будет такой: /{ИмяМетода}

Теперь опубликуем:

Создадим, если ранее не создавали Демо базу на основе БСП 3.0.1.231 (на платформе 8.3.12), и создадим небольшую внешнюю обработку с одной командой ВсеМетоды и реквизитом Результат с типом строка.

 
 Код команды ВсеМетоды

Проверяем результат:

 
Лог из IIS

Из логов видно, что все запросы кроме запроса с методом TRACE отработали и с телом запроса и без.

Результаты метода ANY:

 
 GET
 
 HEAD
 
 PUT
 
 POST
 
 DELETE
 
 PATCH
 
 MERGE
 
 OPTIONS
 
 TRACE
 
 CONNECT

Как мы видим, часть методов имеет схожее назначение за некоторыми отличиями. Большинство API предоставляют клиентам только методы GET, POST и реже PUT.

Давайте сравним GET и POST:

Параметры сравнения

GET

POST

Вступайте в нашу телеграмм-группу Инфостарт

HTTP-сервис API JSON IIS http web apache сервис Публикатор Линк PAPI Pretty API atom-xml XML OData Код состояния СКД БСП Длительные операции

См. также

Инструментарий разработчика Роли и права Запросы СКД Программист Руководитель проекта 1С:Предприятие 8 Платные (руб)

Инструменты для разработчиков 1С 8.3: Infostart Toolkit. Автоматизация и ускорение разработки на управляемых формах. Легкость работы с 1С.

16500 руб.

02.09.2020    273402    1523    422    

1185

Инструментарий разработчика Чистка данных Свертка базы Инструменты администратора БД Системный администратор Программист Руководитель проекта 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Россия Платные (руб)

Инструмент представляет собой обработку для проведения свёртки или обрезки баз данных. Работает на ЛЮБЫХ конфигурациях (УТ, БП, ERP, УНФ, КА и т.д.). Поддерживаются серверные и файловые базы, управляемые и обычные формы, интерфейс 8.5. Может выполнять свертку одновременно в несколько потоков, а также без непосредственного участия пользователя. Решение в Реестре отечественного ПО.

24900 руб.

20.08.2024    77087    389    171    

331

Пакетная печать Печатные формы Инструментарий разработчика Программист 1С:Предприятие 8 Платные (руб)

Расширение для создания и редактирования печатных форм в системе 1С:Предприятие 8.3. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и прозрачность разработки, а также навести порядок в многообразии корпоративных печатных форм. Обновление версии от 21.04.26

22570 руб.

06.10.2023    41286    121    54    

129

Инструментарий разработчика Нейросети Платные (руб)

Первые попытки разработки на 1С с использованием больших языковых моделей (LLM) могут разочаровать. LLMки сильно галлюцинируют, потому что не знают устройства конфигураций 1С, не знают нюансов синтаксиса. Но если дать им подсказки с помощью MCP, то результат получается кардинально лучше. Далее в публикации: MCP для поиска по метаданным 1С, справке синтакс-помощника и проверки синтаксиса.

15250 руб.

25.08.2025    67082    134    38    

142

Инструментарий разработчика Разработка Администрирование веб-серверов Системный администратор Программист Бизнес-аналитик Руководитель проекта 1С 8.3 Платные (руб)

Analyzer 1C сводит выгрузку 1С — основную конфигурацию и все расширения — в единый граф знаний. Любой запрос по связям за доли секунды, с пометками «Доб.» / «Заимств.» / «Переопределено». Новое в 2.0 — обновление поставки: сравнение и объединение версий деревом «как в Конфигураторе» с выгрузкой плана решений; поиск конфликтов из-за перехватов расширений и висячих ссылок; загрузка из бинарных .cf/.cfe; циклические зависимости. Плюс анализ влияния, запросы BSL, роли и RLS, граф вызовов. Минута на развёртывание через Docker без необходимости подключения к Интернет. Любая 1С:Предприятие 8.3+.

14000 руб.

17.04.2026    10190    43    61    

57

Инструменты администратора БД Инструментарий разработчика Роли и права Программист 1С:Предприятие 8 1C:Бухгалтерия Россия Платные (руб)

Расширение позволяет без изменения кода конфигурации выполнять проверки при вводе данных, скрывать от пользователя недоступные ему данные, выполнять код в обработчиках. Не изменяет данные конфигурации, легко устанавливается практически на любую конфигурацию на управляемых формах.

17000 руб.

10.11.2023    27114    99    46    

105

Инструментарий разработчика Программист 1С:Предприятие 8 Платные (руб)

Инструмент для написания и отладки кода в режиме «1С:Предприятие». Представляет собой консоль кода с возможностью пошаговой отладки, просмотра значений переменных любых типов, использования процедур и функций, просмотра стека вызовов, вычисления произвольных выражений на встроенном языке в контексте точки останова, синтаксического контроля и остановки по ошибке. В консоли используется удобный редактор кода с подсветкой, контекстной подсказкой, возможностью вызова конструкторов запроса и форматной строки. 1.3.11 Доработан механизм контекстной подсказки по метаданным

9500 руб.

17.05.2024    55466    189    63    

221
Отзывы
5. dsdred 4276 29.08.18 19:57 Сейчас в теме
(4)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)

Я не про лицензии на подключение web\http-сервисов имел ввиду. Я про тот случай когда клиент использует наш сервис, в своей системе. На картинке ниже изобразил.
Прикрепленные файлы:
Остальные комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. 🅵🅾️🆇 528 28.08.18 12:09 Сейчас в теме
Спасибо за статью и слово "идемпотентный".
3. dsdred 4276 28.08.18 21:34 Сейчас в теме
(1)Не за что ;)) А за слово не мне спасибо, а Бенджамину Пирсу.
2. eeeio 127 28.08.18 16:16 Сейчас в теме
Обязательно продолжайте
4. Cyberhawk 135 29.08.18 15:05 Сейчас в теме
мы знаем, что результат будет формироваться долгое время и нет смысла держать сеанс (лицензию)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)
5. dsdred 4276 29.08.18 19:57 Сейчас в теме
(4)
Веб-/хттп-сервисы не занимают клиентскую лицензию (работают без ее использования)

Я не про лицензии на подключение web\http-сервисов имел ввиду. Я про тот случай когда клиент использует наш сервис, в своей системе. На картинке ниже изобразил.
Прикрепленные файлы:
6. Cyberhawk 135 29.08.18 20:47 Сейчас в теме
(5) Ясно. Но все равно пока не приходит на ум такой сценарий, при котором на стороне потребителя хттп-сервиса такая экономия лицензии будет иметь смысл.
7. dsdred 4276 29.08.18 21:07 Сейчас в теме
(6) Это просто вариант, который возможен, а смысл длительных операций и хранения результата может использоваться во многих вещах. Про одну из таких вещей я сказал в конце данной статьи вскользь - хранение результата для «одинаковых запросов». О еще одной вещице расскажу в 4 части, если соберусь ее писать…
8. maxx 1002 30.08.18 10:54 Сейчас в теме
9. maxx 1002 30.08.18 11:32 Сейчас в теме
Вопросик про длительные операции возник.

Вы в запросе входящем передаёте ИдентификаторЗадания для поиска фонового и АдресРезультат для поиска элемента в справочнике хранилище результатов. А можно ли бы идентификатор задания сохранить в реквизите справочника ХранилищеРезультатов, тогда в url запросе можно было передавать только один параметр АдресРезультата (или вообще уже передавать уникальный идентификатор элемента ХранилищеРезультатов) ?
10. dsdred 4276 30.08.18 12:19 Сейчас в теме
(9)
А можно ли бы идентификатор задания сохранить в реквизите справочника ХранилищеРезультатов, тогда в url запросе можно было передавать только один параметр АдресРезультата (или вообще уже передавать уникальный идентификатор элемента ХранилищеРезультатов) ?


Не вижу смысла хранить идентификатор фонового задания.

Фоновое задание служит для формирования результата и идентификатор нужен только на момент его работы, чтобы понимать ,что фоновое задание еще работает или уже завершено. Пока задание не отработало результата в принципе быть не может. А когда есть результат, идентификатор задания уже не нужен.

У меня в статье описано, что идентификатор задания не обязательный параметр, к результату вы можете потом обращаться так:

http://127.0.0.1/DemoSSL3_0_1_231/hs/PAPI/V1/ФоновоеЗаданиеПроверить?Result_Key=ПолучитьСписокЗаданийЗаПериод_b2fe7494-3e86-4748-bce6-a33d69c14ca2

где Result_Key - адрес результата

Я конечно понимаю что имя метода ФоновоеЗаданиеПроверить несовсем корректно, надо было назвать ПолучитьРезультат или что то в этом духе...
С другой стороны я просто рисую примеры, а не коммерческий проект))
11. akimych 227 17.05.19 17:24 Сейчас в теме
Спасибо за статью.
вопрос про длину URL для метода GET.

Нужно в параметре передавать список ID, но опытным путем выяснили, что в строку URL можно уложить примерно 310 символов.

vs-uat01-1c111/DEV_1/hs/DBReconciliation/GetData/1205687050,1205687070,1205687110,1205697010,1205702490,1205704160,1205704310,1205704320,1205704330,1205711230,1205711240,1205711250,1205711260,1205711270,1205711280,1205711300,1205711310,1205711320,1205711330,1205711340,1205711350,1205711370


Может где-то на IIS есть настройка, на ограничение длины запроса или в 1С органичение на длину передаваемого параметра?

Платформа 8.3.13.
12. dsdred 4276 18.05.19 12:33 Сейчас в теме
(11)Картинка из 4 части

Максимальная длинна URL и максимальная длина строки запроса

Как вариант еще тут посмотрите -> http://qaru.site/questions/327774/wcf-get-url-length-limit-issue-bad-request-invalid-url

Отпишитесь если помогло.
13. akimych 227 20.05.19 12:14 Сейчас в теме
(12) Приветсвую, спасибо за помощь,

помог именно вариант 2, когда в реестре прописали HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Pa­rameters
UrlSegmentMaxLength = 1000.
14. user916652 16.06.20 16:08 Сейчас в теме
Добрый день,

Имеется код на PHP

if ($method == 'GET' && $_GET['hub_mode'] == 'subscribe'
&& $_GET['hub_verify_token'] == VERIFY_TOKEN) {
echo $_GET['hub_challenge'];

В котором при выполнении гет запроса, идет обращение к серверу методом GET. Как с помощью HTTP сервиса обратиться на сервер ($_GET['hub_mode'])
15. dsdred 4276 17.06.20 11:47 Сейчас в теме
(14)
Как с помощью HTTP сервиса обратиться на сервер ($_GET['hub_mode'])

Не совсем понял вопрос.

Вы делаете Get запрос, передаете параметры.
Вопрос в чем? Как в http сервисе прочитать параметры и сделать какие то действия на стороне 1с?


Функция СервисGET(Запрос)
    Ответ = Новый HTTPСервисОтвет(200);
    hub_mode= Запрос.ПараметрыURL.Получить("hub_mode");

//....Какие то действия

    Возврат Ответ;
КонецФункции
16. jenyavp 106 06.11.20 21:50 Сейчас в теме
Добрый вечер. А вы не сталкивались с тем, что при передаче JSON формата более 300 кб процесс зависает на веб сервере. Веб сервер IIS.
JSON формируется в ответ ,устанавливается как строка. Использую HTTP - сервисы в 1С.
Виснет процесс iis worker process. Висит и все. В настройках сайта 30 МБ. Максимальная допустимая длина.
17. dsdred 4276 06.11.20 22:03 Сейчас в теме
(16)Сам не славливал, но попробуйте почитать тут:

https://docs.microsoft.com/ru-ru/dotnet/framework/wcf/feature-details/large-data-and-streaming

При отправке больших объемов данных необходимо задать maxAllowedContentLength параметр IIS (Дополнительные сведения см. в разделе Настройка ограничений запросов IIS) и maxReceivedMessageSize параметр привязки (например, System. ServiceModel. BasicHttpBinding. MaxReceivedMessageSize или MaxReceivedMessageSize ). maxAllowedContentLengthСвойство по умолчанию имеет значение 28,6 МБ, а maxReceivedMessageSize свойство по умолчанию — 64 КБ.

https://docs.microsoft.com/en-us/iis/configuration/system.webserver/security/requestfiltering/requestlimits/
Для отправки сообщения требуется регистрация/авторизация