Авторизация клиента

Для начала сессии обмена данными клиент должен пройти авторизацию по технологии OAuth 2.0

Для этого на сервер Process Insight должен быть направлен запрос вида https://budgetform.appspot.com/x?authorize=XXX, где XXX — ключ компании, с которой будет проводиться обмен данными.

Ключ компании предварительно нужно получить в самом приложении на странице "Справочники/ Автоимпорт":

В ответ на запрос Process Insight вернёт xml-документ, в теге <url> которого будет ссылка, по которой клиент должен перейти для авторизации.

Авторизованный пользователь должен быть зарегистрирован в компании.

После успешной авторизации Process Insight возвращает строку Authorized:

После авторизации сервер Process Insight готов принимать и обрабатывать команды обмена данными.

Авторизация сервера

Process Insight API допускает работу по предварительной авторизации. В этом сценарии пользователь Системы авторизует доступ к функциям API своей учётной записью, получает ключ авторизации и позволяет клиенту API (например, Web-сервису) обращаться к Process Insight API с использованием выданного ключа авторизации. При необходимости пользователь может отозвать выданный ключ авторизации как средствами Process Insight, так и средствами своего OAuth-провайдера.

Авторизация

Для получения ключа авторизации пользователь должен зайти в меню “Настройки/ Настройки импорта”.

В таблице “Настройки автоматического импорта” следует создать новую строку и выбрать схему импорта “API” и сохранить таблицу:

Затем строку следует выбрать (убедиться, что у строки отмечено поле “Выбрать”) и авторизовать (нажать ссылку “Авторизовать выделенные записи” под таблицей).

Система сохранит OAuth-токен. После сохранения токен авторизации, который должен использоваться для доступа к API, находится в поле “Ключ записи”. Поле по умолчанию скрыто, поэтому для получения ключа следует открыть это поле.

Ключ авторизации должен передаваться при каждом запросе сервера в параметре запроса auth.