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

Для интерактивной регистрации можно использовать HTTP-сервис внешней регистрации - ExternalRegistration

В интерактивном режиме сервис внешней регистрации работает совместно с сервисом быстрой регистрации -  FastExternalRegistration

Сервис ExternalRegistration

Для вызова сервиса внешней регистрации выполняется POST-запрос следующего вида:

Запрос

POST {baseURL}/a/httpextreg/hs/ExternalRegistration/register/
Content-Type: application/x-www-form-urlencoded

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

Имя

Тип

Обязательный

Описание

name

Строка

Да

Имя пользователя

email

Строка

Да

Адрес электронной почты пользователя

phone

Строка

Да

Номер телефона пользователя для отправки SMS

promouser

Строка

Да

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

unknownErrorRedirectUrl

Строка


Адрес редиректа при ошибке регистрации

userExistsErrorRedirectUrl

Строка


Адрес редиректа при указании не уникального адреса регистрации

userExistsErrorRedirectMethodPostБулево
Выполнять метод POST при перенаправлении на страницу ошибки при не уникальном адресе регистрации.

promo

Число


Идентификатор сайта

adsrc

Число


Идентификатор источника интереса

sendemail

Булево


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

ssoСтрока
Токен SSO провайдера аутентификации, заполняется из входящих параметров при регистрации с использованием стороннего провайдера аутентификации.

Дополнительные параметры при использовании промокодов

Имя

Тип

Обязательный

Описание

promocodeСтрока
Промокод
subidСтрока
Дополнительная информация о промокоде (например, метод его распространения)

promocodeNotFoundRedirectUrl

Строка

Да

Адрес редиректа при ошибке отсутствия промокода.

promocodeBlockedRediretUrl

Строка

Да

Адрес редиректа при ошибке блокировки промокода.

promocodeExpiredRedirectUrl

Строка

Да

Адрес редиректа при ошибке истечения срока использования промокода.

Дополнительные параметры при использовании защиты от автоматических действий

При использовании в сервисе защиты от автоматических действий среди параметров запроса к HTTP-сервису внешней регистрации может быть необходимо указывать параметр, значение которого возвращается сервисом проверки CAPTCHA (различения людей и роботов). Для сервиса Google reCAPTHA имя этого параметра g-recaptcha-response. Без указания этого параметра в запросе к HTTP-сервису внешней регистрации в регистрации пользователя может быть отказано.

Также в запросе к HTTP-сервису внешней регистрации указывается адрес редиректа при определении что пользователь это робот.

Имя

Тип

Обязательный

Описание

g-recaptcha-responseСтрока
Строка, возвращенная сервисом проверки CAPTCHA
userIsRobotRedirectUrlСтрока
Адрес редиректа при определении что пользователь это робот

Пример страницы для выполнения запроса

<form action="https://1cfresh.com/a/httpextreg/hs/ExternalRegistration/register" method="post" novalidate="novalidate">
    <label>Ваше имя:</label> <input name="name">
    <label>Ваш e-mail:</label> <input name="email">
    <label>Ваш телефон:</label> <input name="phone">
    <input type="hidden" name="promouser" value="ExternalRegistration">
    <input type="hidden" name="unknownErrorRedirectUrl" value="https://task1/#msgUnknownError">
    <input type="hidden" name="userExistsErrorRedirectUrl" value="https://task1/#msgEmailExists">
    <input type="hidden" name="promo" value="9">
    <input type="hidden" name="adsrc" id="adsrc" value="9">
    <input type="submit" value="Начать работу">
</form>

Возвращаемое значение:

  • Если для сайта доступна быстрая регистрация, то производится редирект 302 на сервис быстрой регистрации:
     {baseURL}/a/httpextreg/hs/FastExternalRegistration/CompleteRegistration/{id}, где id – идентификатор приглашения
    • В случае, если приложение не готово, выполняется перезагрузка страницы.
    • Если приложение готово, производится редирект на адрес приложения.
  • Если для сайта не доступна быстрая регистрация, то производится редирект 302 на адрес активации через сервис внешней регистрации
  • Если адрес активации через сервис внешней регистрации не используется, то осуществляется редирект на адрес активации по приглашению

Если сервисом поддерживается быстрая регистрация, можно завершить регистрацию с помощью сервиса FastExternalRegistration.

Обработка ошибок:

Если указаны параметры редиректов, то производится редирект с кодом 302 на указанный адрес. Если адрес этого редиректа не указан, возвращается исключение с кодом 500 и текстом ошибки.

Возможные адреса редиректов:

СитуацияАдрес редиректа
Не указан адрес электронной почты

unknownErrorRedirectUrl

Указанный адрес электронной почты уже используется

userExistsErrorRedirectUrl

В сервисе используется защита от автоматических действия и сервер CAPTCHA определил, что пользователь это роботuserIsRobotRedirectUrl
Прочие ошибкиunknownErrorRedirectUrl

Сервис FastExternalRegistration

Сервис позволяет быстро зарегистрировать приложение пользователя.

Запрос

GET {baseURL}/a/httpextreg/hs/FastExternalRegistration/ComleteRegistration/{id}
Content-Type: application/x-www-form-urlencoded

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

Имя

Описание

Тип

id

Идентификатор приглашения для регистрации

Строка

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

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

В случае ошибок возвращается ответ с кодом 500.