API / Авторизация через Профессионалы.ru используя OAuth2

Шаг 1 Регистрация

Для того, чтобы выполнять запросы к API Профессионалы.ru, необходимо зарегистрироваться в нашей социальной сети.
Это можно сделать на странице регистрации.
Для того, чтобы аккаунт был создан, не обязательно выполнять все шаги регистрации.
Всегда можете к ним вернуться, перейдя на страницу нужного шага, например перейти на шаг 2.

Шаг 2 Создание приложения

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

center

Вы увидите форму создания приложения

center

Описание полей:

  • Домен приложени — путь к вашему приложению
  • Название приложения — название приложения отображаемое в каталоге приложений
  • Внутреннее приложение — внутренние приложения отображаются в каталоге приложений и могут быть открыты на сайте в iframe
  • Описание приложения — описание приложения
  • Иконка приложения — иконка приложения отображаемая в каталоге приложений
  • Требуемые права — права необходимые приложению для работы
  • Категория приложения — категория к которой принадлежит приложение

После создания приложения оно будет доступно в разделе Мои приложения

center

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

Шаг 3 Выполнение запросов к API

Методы авторизации и выполнение запорсов уже подробно рассмотрены в документации, поэтому на этом шаге будет только подробно рассмотрена процедура авторизации на примере.

Для авторизации приложений Профессионалы.ru используется открытый протокол OAuth 2.0.
Авторизация приложения начинается с открытия страницы авторизации:

https://api.professionali.ru/oauth/authorize.html?client_id=APP_CODE&display=popup&response_type=code&redirect_uri=http://example.com/

где APP_CODE — код приложения.

После авторизации и подтверждения прав будет произведено перенаправление на страницу:

http://example.com/?code=AUTH_CODE

где AUTH_CODE — сгенерированный код авторизации.

Сгенерированный код необходимо отправить методу getToken и в ответ получить сгенерированный токен

https://api.professionali.ru/oauth/getToken.json

POST параметры:

client_id=APP_CODE&client_secret=APP_SECRET&code=AUTH_CODE

Ответ сервера:

{   
  "access_token":ACCESS_TOKEN,   
  "expires_in":86400,   
  "user_id":USER_ID   
}

где ACCESS_TOKEN — токен необходимый для выполнения запросов к API;
USER_ID — ID авторизовавшегося пользователя.

Для внешней авторизации на сайте можно получить дополнительную информацию о пользователе воспользовавшись методом получения информации о пользователе:

https://api.professionali.ru/v6/users/get.json?ids[]=me&fields=name,avatar_big&access_token=ACCESS_TOKEN

Ответ

[ 
  { 
    "name":USER_NAME, 
    "avatar_big":USER_AVATAR 
  } 
]

где USER_NAME — имя пользователя;
USER_AVATAR — аватар пользователя.

Если ваше приложение написано на PHP то вы можете воспользоваться нашим клиентом для выполнения запросов к API.
Для удобного тестирования и отладки запорсов к API в можете воспользоваться нашим приложением.

Изображения

Для иконки авторизации можно использовать ниже представленные изображени, по клику полное изображение: