Пример настройки сервиса для использования API программной регистрации (promo_reg)

API программной регистрации в сервисе использует настройки страниц внешней регистрации и все, что с этим связано, в том числе работу обслуживающих организаций и тарификацию.

Подробнее о настройке страниц внешней регистрации написано в документации на ИТС — документ "1С:Облачная подсистема Фреш", глава "Регистрация пользователей на промосайтах".

Рассмотрим пример настройки для использования API программной регистрации.

1. Настройки конфигурации менеджера сервиса

Нужно выполнить следующие действия.

Войти в менеджер сервиса от имени администратора.
Открыть форму Настройки конфигурации: команда меню Главное — Настройки конфигурации (под надписью Сервис).
Перейти на вкладку Возможности этой формы и включить переключатель Отображать обслуживающие организации.
Перейти на вкладку Абоненты и на ней:
1. Если в сервисе не используются витрины, то установить на вложенной вкладке Регистрация флажок Разрешить обслуживающим организациям приглашать новых абонентов.
2. На вложенной вкладке Сервис внешней регистрации:
  - включить переключатель Использовать сервис внешней регистрации абонентов;
  - если в сервисе не используются витрины, то указать на этой вкладке значение параметра Адрес быстрой регистрации.
    Например, если анонимная публикация сервиса быстрой регистрации выполнена по адресу https://1cfresh.local/a/fastreg/hs/FastExternalRegistration, то значение параметра должно быть следующим: https://1cfresh.local/a/fastreg/hs/FastExternalRegistration/CompleteRegistration/{id}
Перейти на вкладку Тарификация и оплата и включить переключатель Использовать контроль тарификации.
Нажать на форме Настройки конфигурации кнопку Записать и закрыть.

2. Настройка витрины

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

Для этого нужно выполнить следующие действия.

Войти в менеджер сервиса от имени администратора.
Открыть форму Витрины: команда меню Обслуживание — Витрины.
Щелкнуть двойным щелчком мыши строку нужной витрины.
В левой части карточки свойств витрины выбрать пункт Внешняя регистрация.
Под надписью Внешняя регистрация:
- включить переключатель Разрешить обслуживающим организациям приглашать новых абонентов
- ввести значение в колонке Адрес строки Быстрая активация выведенной таблицы. Например, если анонимная публикация сервиса быстрой регистрации выполнена по адресу https://1cfresh.local/a/fastreg/hs/FastExternalRegistration, то значение параметра должно быть следующим: https://1cfresh.local/a/fastreg/hs/FastExternalRegistration/CompleteRegistration/{id}
Нажать на форме свойств витрины кнопку Записать и закрыть.

3. Задание тарифа

Добавим новый тариф, который будет использоваться для программной регистрации. Нужно выполнить следующие действия.

Войти в менеджер сервиса от имени администратора или оператора сервиса.
Вывести список тарифов: команда меню Управление тарифами — Тарифы.
Создать новый тариф — кнопка Создать.
В карточке свойств тарифа указать параметры:
- Наименование = Тестовый (программная регистрация) (можно выбрать любое удобное наименование)
- Доступность тарифа = Просмотр и использование в страницах регистрации.
На вкладке Услуги карточки свойств тарифа указать услуги, предоставляемые по тарифу, например:
- Количество активных сеансов = 1
- Количество прав пользователей на запуск приложений = 1
- Количество приложений = 1
На вкладке Виды приложений карточки свойств тарифа указать виды приложений, доступных по тарифу.
Нажать кнопку Записать и закрыть.

4. Задание свойств обслуживающей организации

Программная регистрация осуществляется от имени пользователя обслуживающей организации. У этой обслуживающей организации в свойствах абонента должен быть включен флажок Разрешено подписывать на тарифы. Его можно включить следующим образом.

Войти в менеджер сервиса от имени администратора или оператора сервиса.
Вывести список абонентов: команда меню Обслуживание — Абоненты.
Щелкнуть двойным щелчком мыши строку нужного абонента.
Перейти в карточке свойств абонента на вкладку Настройки регистрации.
Установить флажок Разрешено подписывать на тарифы.
Нажать кнопку Записать и закрыть.

Обслуживающая организация это абонент сервиса, у которого указан параметр Идентификатор и задано представляемое взаимоотношение Обслуживающая организация - Абонент. Подробнее о создании обслуживающих организаций рассказано в документе "1С:Облачная подсистема Фреш", глава "Обслуживающие организации".

5. Пользователь для выполнения программной регистрации

Программная регистрация выполняется от имени пользователя обслуживающей организации.

Владелец обслуживающей организации может либо создать для этого цели специального пользователя, либо использовать любого существующего пользователя абонента.

Для этого пользователя владелец абонента (обслуживающей организации) должен установить параметр Разрешено использовать в настройках регистрации. Это делается следующими образом:

Выбрать в личном кабинете (окне менеджера сервиса) гиперссылку Управление пользователями.
Щелкнуть двойным щелчком мыши строку нужного пользователя в списке Пользователи.
В выведенной карточке свойств пользователя абонента перейти на вкладку Дополнительно.
Включить переключатель Разрешено использовать в настройках регистрации.
Нажать кнопку Записать и закрыть.

6. Создание настройки регистрации абонентов

Теперь владелец обслуживающей организации может создать настройку регистрации абонентов. Для этого ему нужно выполнить следующие действия.

Войти в свой личный кабинет (менеджер сервиса).
Нажать гиперссылку Настройки регистрации абонентов под надписью Обслуживание абонентов.
Нажать кнопку Создать в выведенной форме Настройки регистрации абонентов.
Указать настройки регистрации:
- Наименование = Программная регистрация (можно выбрать любое удобное наименование)
- Пропустить подтверждение регистрационных данных = флажок можно установить
- Создать подписку на тариф = переключатель включен
- Тариф провайдера = Тестовый (программная регистрация) (как было выбрано в разделе 3 выше)
- Период действия = 30 дн. (можно выбрать любой удобный период)
- Создать приложение = переключатель включен
- Вид приложения = Выбрать любой вид приложения, доступный по указанному тарифу
- Способ регистрации = Проморегистрация
- Пользователь для авторизации в сервисе = выбрать пользователя абонента, для которого установлен режим Разрешено использовать в настройках регистрации.
Нажать кнопку Записать и закрыть.

На этом подготовительные действия завершены.

7. Выполнение программной регистрации

Попробуем зарегистрировать в сервисе нового пользователя. При регистрации пользователя автоматически будут выполнены следующие действия

Будет создан новый абонент, и новый пользователь станет владельцем этого абонента.
Будет добавлено приложение абонента.
Абоненту будет назначена подписка на тариф сервиса.

Будем предполагать, что:

Электронная почта регистрируемого пользователя ivanov_ii@mail.com, а полное имя Иванов Иван Иванович.
Подтверждение регистрации пользователем не выполняется.
Отправлять уведомление пользователю на электронную почту не требуется.
Пользователь обслуживающей организации, от имени которого выполняется регистрация, имеет логин Registrator и пароль 123Qwer.
Адрес внешней публикации менеджера сервиса https://1cfresh.local/a/adm

Для начала программной регистрации нужно вызвать метод sign_up http-сервиса Проморегистрация менеджера сервиса:

POST https://1cfresh.local/a/adm/hs/promo_reg/sign_up
Authorization: Basic Registrator 123Qwer
  
{
  "email":"ivanov_ii@mail.com",
  "name": "Иванов Иван Иванович",
  "fast_completion": true,
  "send_notification": false,
}

Должен быть получен ответ о том, что запрос успешно принят к обработке (параметр ответа response имеет значение 10202). Код приглашения возвращается в параметре registration_code, состояние приглашения в параметре state, код создаваемого абонента в параметре account.

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 19 Jun 2026 12:17:54 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 172
Connection: close
Cache-Control: no-cache
Accept-Charset: utf-8

{
  "response": 10202,
  "error": false,
  "message": "",
  "registration_code": "e750d6d5-aac4-4d8a-a748-39dba09492a1",
  "state": "activated",
  "account": 1234
}

Далее выполняем запрос получения адреса приложения (обращаемся к методу get_app_url http-сервиса Проморегистрация менеджера сервиса):

POST https://1cfresh.local/a/adm/hs/promo_reg/get_app_url
Authorization: Basic Registrator 123Qwer
  
{
  "login":"ivanov_ii@mail.com",
  "send_notification": false,
}

Если приложение еще готовится, то в ответе значение параметра response будет равно 10202, а в параметре url будет возвращен адрес быстрой регистрации. Код создаваемого приложения возвращается в параметре tenant.

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 19 Jun 2026 12:22:22 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 637
Connection: close
Cache-Control: no-cache
Accept-Charset: utf-8

{
  "response": 10102,
  "error": false,
  "message": "Приложение не готово.",
  "account": 1234,
  "subscription_id": "000003360",
  "subscription_completion": "2026-07-19T23:59:59",
  "url": "https://1cfresh.local/a/fastreg/hs/FastExternalRegistration/CompleteRegistration/e750d6d5-aac4-4d8a-a748-39dba09492a1",
  "applications": [
    {
      "app": "sbm",
      "permanent_url": "https://1cfresh.local/a/sbm/234567",
      "tenant": 234567,
      "sso_url": ""
    }
  ],
  "permanent_url": "https://1cfresh.local/a/sbm/234567",
  "sso_url": [
    ""
  ],
  "app": "sbm",
  "tenant": 234567
}

Когда приложение подготовится, тогда в ответе значение параметра response будет равно 10201, а в параметре url будет возвращен адрес приложения.

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 19 Jun 2026 12:28:39 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 578
Connection: close
Cache-Control: no-cache
Accept-Charset: utf-8

{
  "response": 10201,
  "error": false,
  "message": "Приложение готово к использованию.",
  "account": 1234,
  "subscription_id": "000003360",
  "subscription_completion": "2026-07-19T23:59:59",
  "url": "https://1cfresh.local/a/sbm/234567",
  "applications": [
    {
      "app": "sbm",
      "permanent_url": "https://1cfresh.local/a/sbm/234567",
      "tenant": 234567,
      "sso_url": ""
    }
  ],
  "permanent_url": "https://1cfresh.local/a/sbm/234567",
  "sso_url": [
    ""
  ],
  "app": "sbm",
  "tenant": 234567
}

8. Проверка результатов

Администратор сервиса может проверить в менеджере сервиса, что при программной регистрации в сервисе были созданы:

Приглашение для регистрации: команда меню Обслуживание — Приглашения для регистрации.
Подписка на нужный тариф от выбранной обслуживающей организации: команда меню Управление тарифами — Подписки.
Приложение вида, указанного в настройке регистрации: команда меню Главное — Приложения.

9. Доступ к API приложения

9.1. Назначение

В некоторых случаях при программной регистрации необходимо предоставить определенному пользователю обслуживающей организации право на доступ к API приложения, создаваемого при регистрации.

Как правило, этот доступ используется для начального заполнения данных приложения.

Следует иметь в виду, что право на доступ к API приложения должно предоставляться с разрешения абонента, которому принадлежит приложение.

Согласие на доступ к API приложения может быть включено в договор с клиентом или в текст принимаемой им оферты.

9.2. Пользователь для доступа к API

Обычно доступ к API приложений осуществляется от имени отдельного, специально созданного, пользователя обслуживающей организации.

При создании этому пользователю можно назначить роль Пользователь абонента и не давать доступа ни к каким приложениям обслуживающей организации.

От имени этого пользователя, как правило, не выполняется интерактивная работа ни с какими с приложениями.

9.3. Изменение настройки регистрации абонентов

Администратор сервиса может добавить в имеющуюся настройку регистрации абонентов указание на необходимость устанавливать доступ к API приложения.

Для этого нужно выполнить следующие действия.

Войти в менеджер сервиса от имени администратора.
Выбрать команду меню Обслуживание — Настройки регистрации абонентов.
Щелкнуть двойным щелчком мыши строку нужной настройки регистрации.
В карточке свойств настройки регистрации выбрать в поле Установить доступ к API приложения пользователю пользователя, от имени которого будет выполняться доступ к API приложений.
Нажать кнопку Записать и закрыть.

9.4. Выполнение программной регистрации

Программная регистрация с предоставлением права на доступ к API приложения выполняется так же, как описано выше (см. раздел 7).

9.5. Проверка прав доступа к API

Для проверки, что пользователю был предоставлен доступ к API приложения, созданного при программной регистрации, можно выполнить следующие действия.

Войти в менеджер сервиса от имени администратора сервиса.
Вывести список Приложения: команда меню Главное — Приложения.
Щелкнуть в списке Приложения двойным щелчком мыши строку приложения, созданного при программной регистрации.
В выведенной карточке свойств приложения выбрать в меню команду Еще — Права доступа (Объект).
В выведенной таблице Права доступа для данного пользователя (колонка Субъект) должны быть указаны права Доступ к API и Чтение.

9.6. Отключение от абонента пользователя, имеющего право на доступ к API приложения

Если доступ к API приложения больше не нужен (например, он использовался только для начального заполнения данных приложения), то владелец или администратор абонента могут отключить от своего абонента пользователя, от имени которого выполнялся доступ к API:

Выбрать в личном кабинете (окне менеджера сервиса) гиперссылку Управление пользователями.
Выделить строку пользователя, от имени которого выполнялся доступ к API.
Нажать кнопку Отключить от абонента.