1c/mi
1
0
mirror of https://github.com/rdv-team/mi.git synced 2025-11-23 21:31:02 +02:00
Files
mi/doc/admin/how_to_HTTP.md

52 lines
3.7 KiB
Markdown
Raw Permalink Normal View History

**Цель:** Опубликовать HTTP-сервис `рдв_Интеграция` для работы интеграции.
#### **Шаг 1: Настройка основной публикации**
1. Откройте **Конфигуратор** и перейдите в меню **Администрирование** -> **Публикация веб-сервисов**.
2. Заполните вкладку **«Основные»**:
- **Имя:** Укажите имя виртуального каталога (например, `buh`). Это будет первая часть пути в URL:
`http://<Сервер>/`**`<ИмяПубликации>`**`/hs/...`
- **Веб-сервер:** Выберите тип установленного на сервере ПО (IIS, Apache).
- **Каталог:** Укажите **существующий** локальный путь на диске сервера (например, `C:\inetpub\wwwroot\buh`). _Здесь будет создан служебный файл_ `default.vrd`.
- **Публиковать доступ для клиентских приложений:** **Снимите** эту галочку, если веб-клиент не требуется. Это повышает безопасность.
- **Публиковать стандартный интерфейс OData**, **Публиковать систему аналитики:**Оставьте **выключенными**, если иное не требуется.
#### **Шаг 2: Публикация HTTP-сервиса**
1. Перейдите на вкладку **«HTTP-сервисы»**.
2. Убедитесь, что флажок **«Публиковать HTTP-сервисы по умолчанию»** снят, если иное не требуется.
3. В **«Списке сервисов»** найдите и отметьте галочкой сервис `рдв_Интеграция`.
4. **Обратите внимание на колонку `Корневой URL`** (например, `rdv_integration`). Именно это значение будет частью пути URL.
#### **Шаг 3: Завершение публикации**
1. Нажмите кнопку **`Опубликовать`**.
2. **Важно!** Программа предложит перезапустить веб-сервер (IIS/Apache). Подтвердите действие. _Учтите, что если на сервере опубликованы другие сервисы, кратковременный перезапуск не повлияет на их работу._
#### **Формирование URL для запроса**
Формат конечного URL для вызова метода:
`http(s)://<Сервер>/<ИмяПубликации>/hs/<КорневойURLСервиса>/<ИмяМетода>`
- **`<Сервер>`**: Адрес вашего сервера (например, `localhost``api.company.com`).
- **`<ИмяПубликации>`**: Имя, указанное на вкладке «Основные» (например, `buh`).
- **`/hs/`**: Обязательный префикс для всех HTTP-сервисов 1С.
- **`<КорневойURLСервиса>`**: Значение из колонки «Корневой URL» (в нашем случае `rdv_integration`).
- **`<ИмяМетода>`**: Имя метода, реализованного в модуле сервиса (например, `exchange`).
**Пример готового URL:**
`http://api.company.com/buh/hs/rdv_integration/exchange`