Общие сведения

HTTP-cервис менеджера сервиса ПромоРегистрация предназначен для регистрации пользователя в облачном сервисе Фреш и выполняет следующие операции:

  1. Создание нового абонента
  2. Создание нового пользователя абонента
  3. Создание приложения нового абонента и оформление подписки на тариф
  4. Оповещение пользователя о регистрации в сервисе и создании приложения.

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

Общие параметры, используемые в запросах к сервису

ИмяОписаниеПример
serverАдрес сервера сервиса. https://1cfresh.com
regАдрес сервиса регистрации. a/adm/hs/promo_reg
authorizationДанные авторизации Логин:Пароль в base64


Обычно HTTP-cервис менеджера сервиса ПромоРегистрация публикуется во внешней публикации менеджера сервиса. Корневое имя HTTP-cервиса  promo_reg. 

Общие параметры ответов всех методов

ПараметрТипОписание
errorБулевоУказывает, что во время выполнения метода возникла ошибка.
responseЧислоКод возврата. У каждого метода свой набор кодов возврата.
messageСтрокаКомментарий к выполненной операции (например, описание ошибки).

Пользователю менеджера сервиса, от имени которого вызывается какой-либо метод сервиса, должны быть назначены роли:

  • УдаленныйДоступБыстраяРегистрация
  • УдаленныйДоступВнешняяРегистрация

Также в информационной базе менеджера сервиса должны быть штатным образом настроены разрешения внешней регистрации.

Методы сервиса ПромоРегистрация

Сервис ПромоРегистрация поддерживает следующие методы:

МетодНазначение
check_userПроверяет существование в сервисе пользователя с указанным логином.
check_available_appПолучает список доступных видов приложений для тарифа.
sign_upИнициирует регистрацию абонента в сервисе и создание нового приложения (тип приложения определяется настройками внутри сервиса).
get_user_idВозвращает идентификатор пользователя сервиса по его логину.
get_app_urlВозвращает URL созданного приложения по указанному логину пользователя.
send_notificationОтправляет пользователю оповещение о результатах регистрации.
authorization_codeЗапрос кода авторизации стороннего приложения для нового зарегистрированного пользователя.
send_verificationОтправка письма верификации пользователю сервиса для авторизации стороннего приложения.

Метод check_user

Проверяет существование в сервисе пользователя с указанной электронной почтой.

Параметры запроса

ПараметрТипОбязательныйЗначение
email Строка (50)ДаАдрес электронной почты пользователя
validate_emailБулевоНетЕсли Истина, то проверяет адрес электронной почты на соответствие требованиям RFC 5321, RFC 5322, RFC 5335, RFC 5336 и RFC 3696. По умолчанию = Ложь.

Параметры ответа

ПараметрТипЗначение
urlСтрокаURL приложения, созданного при регистрации (если приложение уже подготовлено).
accountЧислоКод абонента, созданного при регистрации.
tenantЧислоНомер области, адрес которой приведен в параметре  url .
Пример запроса  Развернуть
POST {{server}}/{{reg}}/check_user
Authorization: Basic {{authorization}}
 
{
  "email":"user@mail.com",
  "validate_email": true
}
Пример ответа для организации, регистрировавшей абонента  Развернуть
{
  "error": false,
  "response": 10403,
  "message": "Указанный адрес электронной почты уже используется.",
  "url": "https://1cfresh.com/a/smtl/20",
  "tenant": 20,
  "account": 11
}
Пример ответа для прочей обслуживающей организации  Развернуть
{
  "error": false,
  "response": 10403,
  "message": "Указанный адрес электронной почты уже используется.",
  "url": "",
  "tenant": 0,
  "account": 0
}
Пример запроса с некорректным адресом электронной почты  Развернуть
POST {{server}}/{{reg}}/check_user
Authorization: Basic {{authorization}}
 
{
  "email":"user_mail.com",
  "validate_email": true
}
Пример ответа при некорректном адресе электронной почты  Развернуть
{
  "error": true,
  "response": 10400,
  "message": "Указан некорректный адрес электронной почты.",
  "url": "",
  "tenant": 0,
  "account": 0
}

Возможные коды ответа

Код

Значение

10200Пользователь существует
10400Обязательные параметры либо не указаны, либо некорректны
10403Пользователь существует, информация по пользователю не доступна
10404Пользователь с указанным логином не найден
10500Внутренняя ошибка
10509Не удалось однозначно определить абонента пользователя

Параметры ответа  url account  и  tenant  метода c heck_user  заполняются только в том случае, когда запрашивается информация о пользователях, которые были ранее зарегистрированы методом sign_up от имени той же обслуживающей организации.
Если запрашивается информация о пользователе, который был зарегистрирован в сервисе каким-то другим способом (или от имени другой обслуживающей организации), параметры  url account и  tenant  
не заполняются.

Метод check_available_app

Получить список доступных видов приложений для тарифа

Параметры запроса

ПараметрТипОбязательныйЗначение
tariffСтрока (9)ДаКод тарифа, для которого надо получить список доступных видов приложений

Параметры ответа

ПараметрТипЗначение
applicationsМассивМассив структур вида:
  • name – Строка – имя вида приложения
  • id – Строка – код вида приложения
Пример запроса  Развернуть
POST {{server}}/{{reg}}/check_available_app
Authorization: Basic {{authorization}}
 
{
  "tariff":"000000001"
}
Пример ответа  Развернуть
{
  "error": false,
  "response": 10200,
  "message": "",
  "applications": [
    {
      "name": "Библиотека технологии сервиса, редакция 2.0",
      "id": "smtl"
    },
    {
      "name": "Управление нашей фирмой",
      "id": "sbm"
    }
  ]
}

Возможные коды ответа

КодЗначение
10200Успешное выполнение
10400Не указан код тарифа
10404Не найден тариф с указанным кодом или для тарифа нет доступных видов приложений

Метод sign_up

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

Перед регистрацией переданный адрес электронной почты проверяется на соответствие требованиям стандартов (RFC 5321, RFC 5322, RFC 5335, RFC 5336 и RFC 3696).

Если в настройках внешней регистрации для пользователя, от имени которого вызывается метод сервиса, указан провайдер аутентификации, то:

  • если в запросе передан идентификатор пользователя этого провайдера (параметр sso_user_id ), то после регистрации становится доступен вход в приложения этого пользователя через указанного провайдера аутентификации;
  • если в запросе указан параметр  user_info , то при регистрации будет выполнено заполнение свойств созданного абонента согласно правилу трансляции, заданному в свойствах указанного провайдера аутентификации в менеджере сервиса.

Параметры запроса

ПараметрТипОбязательныйЗначение
nameСтрока(64)ДаОтображаемое имя пользователя, не логин.
emailСтрока(50)ДаАдрес электронной почты. Также является логином пользователя в сервисе.
phoneСтрока
Контактный телефон пользователя (не обязательный).
public_idСтрока(36)
Публичный идентификатор. Может использоваться для заполнения свойств абонента. Например, для автоматического заполнения свойств организации по ИНН.
tariffСтрока(9)
Код тарифа, на который нужно подписать абонента. Если не указан, будет использован тариф, заданный в настройках системы по умолчанию.
servant_tariff *Строка переменная (9)
Код тарифа обслуживающей организации. Значение игнорируется, если не указан параметр tariff.
validityЧисло
Продолжительность действия подписки в днях, если для выбранного тарифа не используются периоды действия. Если параметр не указан, будет использовано значение, заданное в настройках системы по умолчанию.
Если параметр tariff  заполнен и для выбранного тарифа не используются периоды действия, то параметр validity также должен быть заполнен.
app Массив

Массив структур вида:

  • id – Строка – имя вида приложения
  • count – Строка – количество создаваемых приложений
periodСтрока(10)
Код периода действия подписки. Если параметр  tariff  заполнен и для выбранного тарифа используются периоды действия, то параметр period также должен быть заполнен.
tenants_countЧисло
Количество создаваемых приложений. Если не указано, создается одно приложение.
fast_completionБулево
Указывает, что необходимо сразу же инициировать процесс подтверждения регистрации и начать подготовку приложения (по умолчанию = Ложь). Если передано значение = Ложь, то для активации регистрации нужно использовать значение поля  registration_code , из ответа но этот метод.
send_notificationБулево
Указывает, что необходимо отправить уведомление на почту пользователя сразу же после регистрации (по умолчанию = Истина).
sso_user_idСтрока(256)
Идентификатор пользователя провайдера аутентификации.
user_infoСтруктура
Информация о пользователе, аналогичная выдаваемой провайдером аутентификации. Используется для заполнения свойств абонента.
promocode Строка
Промокод.
subidСтрока
Дополнительная информация о промокоде (например, метод его распространения).
site_idЧисло
Код сайта внешней регистрации. Влияет на выбор шаблона письма о регистрации в сервисе, отправляемого пользователю.

Совместное использование параметров запроса  app и  tenants_count  метода sign_up запрещено .

Если в настройках внешней регистрации для пользователя, от имени которого вызывается метод сервиса, указан провайдер аутентификации, то:

  • если в запросе передан идентификатор пользователя этого провайдера (параметр sso_user_id ), то после регистрации становится доступен вход в приложения этого пользователя через указанного провайдера аутентификации;
  • если в запросе указан параметр  user_info , то при регистрации будет выполнено заполнение свойств созданного абонента согласно правилу трансляции, заданному в свойствах указанного провайдера аутентификации в менеджере сервиса.

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

Параметры ответа

ПараметрТипЗначение
registration_codeСтрока(36)

Уникальный регистрационный код приглашения. Для дальнейших действий в рамках сервиса проморегистрации этот код не используется.
Код можно использовать на стороне клиента, если нужен быстрый переход пользователя в создаваемое в рамках регистрации приложение.
В этом случае нужно использовать сервис быстрой регистрации, подставив полученный код в запрос:

GET {baseURL}/a/fastreg/hs/FastExternalRegistration/ComleteRegistration/{registration_code}

Подробнее см. Интерактивная регистрация – сервис FastExternalRegistration

Пример запроса с указанием непериодического тарифа  Развернуть
POST {{server}}/{{reg}}/sign_up
Authorization: Basic {{authorization}}
 
{
  "email":"user@mail.com",
  "name": "User",
  "fast_completion": true,
  "public_id": "773064301401",
  "send_notification": false,
  "tariff": "2",
  "validity": "30",
  "tenants_count": 1 
}
Пример запроса с указанием периодического тарифа  Развернуть
POST {{server}}/{{reg}}/sign_up
Authorization: Basic {{authorization}}
 
{
  "email":"user@mail.com",
  "name": "User",
  "fast_completion": true,
  "send_notification": false,
  "tariff": "4",
  "servant_tariff": "000000007", 
  "period": "6MN",
  "tenants_count": 1  
}
Пример запроса с указанием массива создаваемых приложений  Развернуть
POST {{server}}/{{reg}}/sign_up
Authorization: Basic {{authorization}}
 
{
  "email":"user@mail.com",
  "name": "User",
  "fast_completion": true,
  "public_id": "773064301401",
  "send_notification": false,
  "tariff": "000000001",
  "validity": "30",
  "app": [
      {
        "count": 2,
        "id": "ea"
      },
      {
        "count": 1,
        "id": "sbm"
      }
    ]
}
Пример запроса с заполнением свойств абонента  Развернуть
POST {{server}}/{{reg}}/sign_up
Authorization: Basic {{authorization}}
 
{
  "email":"pupkin@yopmail.com",
  "name": "Василий Пупкин",
  "sso_user_id": "portal_id",
  "user_info":
    {
      "ev_token": "1234-5678-9800"
    }
}
Пример ответа  Развернуть
{
  "error": false
  "response": 10202
  "message": " "
  "registration_code": "9fdb128e-bb3a-11e7-6381-08002798b77b"
}

Приведение к периодам продолжительности действия подписки, указанной в днях

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

Если в запросе был указан параметр validity , выбранный тариф периодический и было успешно выполнено приведение продолжительности действия подписки к допустимому значению, то метод sign_up вернет код ответа 10242, а в параметре ответа message  будет содержаться сообщение об автоматическом приведении продолжительности действия подписки к допустимому значению.

Пример ответа при точном совпадении количества дней по периоду тарифа с переданным validity = 183  Развернуть
{
  "error": false,
  "response": 10242,
  "message": "Для периодического тарифа требуется указание кода периода параметром 'period' вместо указанного параметра 'validity'.",
  "registration_code": "6c6df62a-b9ce-11e9-7f9e-0242ac160004"
}
Пример ответа при неточном указании количества дней периодом validity = 180  Развернуть
{
  "error": false,
  "response": 10242,
  "message": "Для периодического тарифа требуется указание кода периода параметром 'period' вместо указанного параметра 'validity'. Количество дней скорректировано в соответствии с периодом '6MN'",
  "registration_code": "19060faa-b9cd-11e9-7f9e-0242ac160004"
}

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

Возможные коды ответа

КодЗначение
10202Запрос на регистрацию успешно принят к обработке, регистрационный код возвращен в параметре registration_code
10242Запрос на регистрацию успешно принят к обработке, однако параметры запроса были скорректированы. Регистрационный код возвращен в параметре registration_code
10400Обязательные параметры либо не указаны, либо некорректны (например, указан код тарифа обслуживающей организации, не соответствующий тарифу провайдера) 
10400Идентификатор пользователя не может быть привязан
10404Не найден тариф или тариф обслуживающей организации с указанным кодом
10404Вид приложения с указанным кодом недоступен для использования
10406Некорректное значение количества приложений. Ожидается положительное число
10406Некорректно указаны периоды действия, подробности в сообщении
10406Указанный идентификатор пользователя уже используется
10406Запрещено использовать параметр tenants_count совместно с app
10412Количество приложений превышает доступный лимит по тарифу
10409Указанный адрес электронной почты уже используется в сервисе
10422Длина адреса электронной почты превышает допустимое значение. Допустимо не более 50 символов.
10452Промокод не найден или исчерпано количество активаций промокода
10453Промокод заблокирован
10454Срок активации промокода истек
10500Внутренняя ошибка

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

Сообщение "Указанный идентификатор пользователя уже используется" выводится, если параметр  sso_user_id передан и уже используется для текущего провайдера.

Сообщение "Не найден провайдер сторонней аутентификации" выводится, если в запросе указан параметр   sso_user_id , но в настройках внешней регистрации для пользователя, от имени которого вызывается метод сервиса, провайдер аутентификации не задан.

Метод get_user_id

Возвращает идентификатор пользователя сервиса по его логину.

Параметры запроса

ПараметрТипОбязательныйЗначение
loginСтрока (50)ДаЛогин пользователя в сервисе (адрес электронной почты).

Параметры ответа

ПараметрТипЗначение
useridСтрока (36)Идентификатор пользователя сервиса (UID).
Пример запроса  Развернуть
POST {{server}}/{{reg}}/get_user_id
Authorization: Basic {{authorization}}
 
{
  "login":"user@mail.com"
}
Пример ответа  Развернуть
{
  "error": false,
  "response": 10200,
  "message": "",
  "userid": "80f69852-eb3b-11e7-819b-0050568925e0"
}
Параметр ответа  userid  заполняется только в том случае, когда запрашивается информация о пользователях, которые были ранее зарегистрированы методом sign_up от имени того же самого служебного пользователя. Если запрашивается информация о пользователе, который был зарегистрирован в сервисе каким-то другим способом (или от имени другого служебного пользователя), параметр  userid  не заполняются.

Метод get_app_url

Возвращает URL созданного приложения по указанному логину пользователя.

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

Параметры запроса

Параметр

ТипОбязательныйЗначение
loginСтрока (50)ДаЛогин пользователя в сервисе (адрес электронной почты).
send_notificationБулевоНетУказывает, что необходимо отправить уведомление на почту пользователя сразу же после подготовки приложения.

Параметры ответа

ПараметрТипЗначение
urlСтрока, МассивАдрес перехода после регистрации:
  • если регистрация приложения завершена, возвращается постоянный адрес приложения. Если запрашивалось создание нескольких приложений, то возвращается массив.
  • если регистрация не завершена, возвращается адрес страницы завершения регистрации
sso_urlМассивМассив адресов для перехода в приложение через сторонний провайдер аутентификации. Массив заполняется если:
  • у пользователя, указанного параметром login,  имеется идентификатор стороннего провайдера аутентификации;
  • пользователь, от имени которого выполняется запрос , должен принадлежать стороннему провайдеру аутентификации, настройки которого указаны в МС.
accountЧислоКод абонента, созданного при регистрации
appСтрокаИмя приложения (код вида приложения)
tenantЧисло, МассивНомер области, адрес которой приведен в параметре  url . Если запрашивалось создание нескольких приложений, то возвращается массив
permanent_urlСтрока, МассивПостоянный адрес приложения (возвращается в любом случае, даже пока приложение не готово к использованию). Если запрашивалось создание нескольких приложений, то возвращается массив
subscription_idСтрока (9)Номер подписки созданной по приглашению для регистрации
subscription_completionДатаДата окончания подписки созданной по приглашению для регистрации
applicationsМассивМассив со сведениями о созданных приложениях. Параметр возвращается, если при промо-регистрации было создано несколько приложений разных типов
Пример запроса  Развернуть
POST {{server}}/{{reg}}/get_app_url
Authorization: Basic {{authorization}}
 
{
  "login":"user@mail.com",
  "send_notification": false
}
Пример ответа  Развернуть
{
  "error": false,
  "response": 10201,
  "message": "",
  "url": "https://1cfresh.com/a/smtl/20",
  "sso_url": [],
  "tenant": 20,
  "account": 3,
  "app": "smtl",
  "permanent_url": "https://1cfresh.com/a/smtl/20",
  "subscription_id": "000000007",
  "subscription_completion": "2020-08-06T23:59:59"
}
Пример ответа при запросе нескольких приложений  Развернуть
{  
   "error":false,
   "response":10201,
   "message":"",
   "url":[  
      "https://1cfresh.com/a/smtl/20",
      "https://1cfresh.com/a/smtl/21",
      "https://1cfresh.com/a/smtl/22"
   ],
  "sso_url": [ 
    "https://1cfresh.com/a/openid/e1cib/oid2op/sso/login/iva_auth?return_to=https%3A%2F%2F1cfresh.com%2Fa%2Fsmtl%2F20",
    "https://1cfresh.com/a/openid/e1cib/oid2op/sso/login/iva_auth?return_to=https%3A%2F%2F1cfresh.com%2Fa%2Fsmtl%2F21",
    "https://1cfresh.com/a/openid/e1cib/oid2op/sso/login/iva_auth?return_to=https%3A%2F%2F1cfresh.com%2Fa%2Fsmtl%2F22"
   ],
   "tenant":[  
      20,
      21,
      22
   ],
   "account":3,
   "app":"smtl",
   "permanent_url":[  
      "https://1cfresh.com/a/smtl/20",
      "https://1cfresh.com/a/smtl/21",
      "https://1cfresh.com/a/smtl/22"
   ],
  "subscription_id": "000000008",
  "subscription_completion": "2020-08-06T23:59:59"
}
Пример ответа в случае, если при промо-регистрации было создано несколько приложений разных типов  Развернуть
{
  "error": false,
  "response": 10201,
  "message": "",
  "url": "",
  "applications": [
    {
      "app": "ea",
      "permanent_url": "https://1cfresh.com/a/ea/4965329",
      "tenant": 4965329,
      "sso_url": "https://1cfresh.com/a/oid/hs/oid2op/sso/login/tstp?cmd=form&return_to=https%3A%2F%2F1cfresh.com%2Fa%2Fea%2F4965329"
    },
    {
      "app": "sbm",
      "permanent_url": "https://1cfresh.com/a/sbm/5001234",
      "tenant": 5001234,
      "sso_url": "https://1cfresh.com/a/oid/hs/oid2op/sso/login/tstp?cmd=form&return_to=https%3A%2F%2F1cfresh.com%2Fa%2Fsbm%2F5001234"
    }
  ],
  "account": 21456,
  "subscription_id": "000008019",
  "subscription_completion": "2021-09-29T23:59:59"
}
Пример ответа при отсутствии завершенной регистрации  Развернуть
{
  "error": false,
  "response": 10500,
  "message": "По указанному логину пользователя не обнаружено завершенной регистрации.",
  "url": "",
  "sso_url": [],
  "tenant": 0,
  "account": 0,
  "app": "",
  "permanent_url": "",
  "subscription_id": "",
  "subscription_completion": ""
}

Возможные коды ответа

Код

Значение

10201Приложение успешно создано, адрес возвращен в параметре url .
10102Приложение в процессе создания, необходимо обратиться позже
10400Обязательные параметры либо не указаны, либо некорректны
10408Истекло допустимое время быстрой регистрации
10409Пользователь был зарегистрирован в сервисе другим партнером
10500Внутренняя ошибка

Метод send_notification

Отправляет пользователю оповещение о результатах регистрации.

Параметры запроса

ПараметрТипОбязательныйЗначение
loginСтрока (50)ДаЛогин пользователя в сервисе (адрес электронной почты)
Пример запроса  Развернуть
POST {{server}}/{{reg}}/send_notification
Authorization: Basic {{authorization}}
 
{
  "login":"user@mail.com"
}
Пример ответа если оповещение отправлено  Развернуть
{
  "error": false,
  "response": 10200,
  "message": ""
}

Возможные коды ответа

КодЗначение
10200Оповещение успешно отправлено.
10403У текущего пользователя нет доступа на отправку оповещения этому пользователю.
Оповещение отправляется только в том случае, если запрос отправляется от имени того же пользователя, который ранее регистрировал клиента методом sign_up.

 Метод authorization_code

Запрос кода авторизации стороннего приложения.

Параметры запроса

ПараметрТипОбязательныйОписание
loginСтрока ДаЛогин пользователя сервиса.

client_id 

СтрокаДаИдентификатор клиента стороннего приложения.
client_secret СтрокаДаСекрет клиента стороннего приложения.

Параметры ответа

ПараметрТипЗначение
codeСтрокаКод авторизации стороннего приложения.
expires_inЧислоСрок жизни кода авторизации.
refirect_uriМассив из СтрокаАдреса возвратов.

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

Для других случаев нужно использовать метод send_verification или использовать OAuth2 способ аутентификации пользователя с дальнейшей передачей кода доступа и обмена его на токен.

Пример запроса  Развернуть
POST https://{{server}}/{{reg}}/authorization_code
Authorization: Basic {{authorization}}
Content-Type: application/json
  
{
  "login": "client@yopmail.com", 
  "client_id": "1c.cloud",
  "client_secret": "secret-123Qwer"
}
Пример ответа  Развернуть
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Cache-Control: no-cache, no-store
Pragma: no-cache
...

{
  "response": 10200,
  "error": false,
  "message": "",
  "code": "ewoiY...",
  "expires_in": 600,
  "redirect_uri": [
    "https://1c.cloud/callback"
  ]
}

Полученный код авторизации может использоваться для предоставления доступа приложению к данным пользователя и получения токенов доступа и обновления, при обращению к методу {server}/a/openid/e1cib/oid2op/token.

Возможные коды ответа

КодЗначение
10200Код авторизации успешно получен.
10404Пользователь с логином ''%1'' не найден.
10403Получение кода авторизации доступно только для первичных регистраций.
10400

Не найдено стороннее приложение по %1 = %2'

Некорректный секрет клиента %1 = %2

Метод send_verification

Отправка письма верификации пользователю сервиса для авторизации стороннего приложения.

Параметры запроса

ПараметрТипОбязательныйЗначение
emailСтрокаДаПочта пользователя сервиса.
client_idСтрокаДаИдентификатор клиента стороннего приложения.
client_secretСтрокаДаСекрет клиента стороннего приложения.
redirect_uriСтрокаДаПодтвержденный адрес перенаправления в стороннее приложение.
stateСтрокаДаВозвращаемый статус стороннего приложения.
Пример запроса  Развернуть
POST https://{{server}}/{{reg}}/send_verification
Authorization: Basic {{authorization}}
Content-Type: application/json
  
{
  "email": "{{username}}", 
  "client_id": "1c.cloud",
  "client_secret": "secret-123Qwer",
  "redirect_uri": "https://1c.cloud/callback",
  "state": "12345"
}
Пример ответа  Развернуть
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
...

{
  "response": 10200,
  "error": false,
  "message": ""
}

В результате вызова метода пользователю отправляется письмо с code и с ссылкой переходом на callback стороннего сервиса.

После перехода по ссылке из почты стороннее приложение получит код авторизации.
Полученный код авторизации может использоваться для предоставления доступа приложению к данным пользователя и получения токенов доступа и обновления, при обращению к методу {server}/a/openid/e1cib/oid2op/token .

Возможные коды ответа

Код

Значение

10200Письмо верификации успешно отправлено.
10404Пользователь с адресом электронной почты ''%1'' не найден.
10400

Не найдено стороннее приложение по %1 = %2'

Некорректный секрет клиента %1 = %2

Адрес перенаправления ''%1'' недоступен.