Авторизация клиента
Для начала сессии обмена данными клиент должен пройти авторизацию по технологии 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.