OAuth

Позволяет установить кнопку "Войти через Senler" на сайте разработчика для получения API - ключа, который позволит выполнять API - запросы в Senler

Для включения данной опции нужно поставить галочку "Авторизация на стороннем сайте (OAuth)" в настройках приложения:

Мы используем открытый протокол OAuth 2.0. При этом пользователь не передает логин и пароль приложению, поэтому его аккаунт не может быть скомпрометирован.

Вы можете получить ключ для работы с API методами сообщества

Используйте Authorization Code Flow для вызова методов API Senler с серверной части вашего приложения (например, из PHP).

Необходимо перенаправить браузер пользователя по адресу

Открытие диалога авторизации

GEThttps://senler.ru/cabinet/OAuth2authorize

Query parameters

Response

200301

Диалоговое окно выбора сообществ

Request

JavaScriptCurlPython

const response = await fetch('https://senler.ru/cabinet/OAuth2authorize?client_id=text&state=text&redirect_uri=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Пример запроса:

https://senler.ru/cabinet/OAuth2authorize?group_id=342173client_id=1&redirect_uri=https://mysite.ru/test_callback.php&state=63edf60ef1837b36ca611328

Если пользователь не вошел на сайт, то в диалоговом окне ему будет предложено ввести свой логин и пароль.

Если не задан group_id , то в диалоговом окне ему будет предложено выбрать сообщество куда установить приложение.

Получение code

После успешной авторизации приложения браузер пользователя будет перенаправлен по адресу redirect_uri, указанному при открытии диалога авторизации. При этом код для получения ключа доступа code будет передан как GET-параметр:

REDIRECT_URI?code=7a6fa4dff77a228eeda56603b8f53806c883f011c40b72630bb50df056f6479e52a

Параметр code может быть использован в течение 2.5 часа для получения ключа доступа к API access_token с вашего сервера.

Получение access_token

Для получения access_token необходимо выполнить запрос с вашего сервера на:

Получение access_token

GEThttps://senler.ru/ajax/cabinet/OAuth2token

Query parameters

Response

200

successful operation

Body

application/json

successboolean

Example: true

access_tokenstring

Example: "f16bf6069c353f0e9eec6a134450bb19b3df2626fd8d1c52"

Request

JavaScriptCurlPython

const response = await fetch('https://senler.ru/ajax/cabinet/OAuth2token?client_id=text&client_secret=text&redirect_uri=text&code=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "success": true,
  "access_token": "f16bf6069c353f0e9eec6a134450bb19b3df2626fd8d1c52"
}

Пример запроса:

https://senler.ru/ajax/cabinet/OAuth2token?client_id=1&client_secret=6a5220b486f038d681d68599a68f6ac4470cd563&redirect_uri=http://mysite.ru&code=3e46f5ad365f8ae443c516642ffbfef3a9e1e859

В результате выполнения данного запроса ваш сервер получит вновь созданный access_token. Токен бессрочный.

{
  "access_token": "533bacf01e11f55b536a565b57531ac114461ae8736d6506a3",
  "success": "true"
}