Пример взаимодействия с Odnoklassniki Rest API на C#.

Итак, как и обещал, продолжаю тему взаимодействия с различными API. В прошлый раз писал про API ВКонтакте, сегодня напишу про API Одноклассников.

Первое, что нам нужно сделать - это зарегистрироваться как разработчик на Одноклассниках.

Сделать это можно по следующей ссылке Форма регистрации разработчика приложений

Получив права разработчика, необходимо зарегистрировать сайт как приложение. Подробно как это сделать можно прочитать здесь

После того как сайт будет зарегистрирован придет письмо, содержащее:

Application ID: xxxxxx.
Публичный ключ приложения: xxxxxxxxxxxxxxxxxxxxxxxxx.
Секретный ключ приложения:  xxxxxxxxxxxxxxxxxxxxxxxxx.
Ссылка на приложение: http://www.odnoklassniki.ru/games/xxxxx

Используя эти данные можно начать работу с API.

Для выполнения запросов к API пользователь должен авторизоваться в Одноклассниках.

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

http://www.odnoklassniki.ru/oauth/authorize?client_id={0}&scope={1}&response_type=code&redirect_uri={2} , где

client_id - Application ID;

scope - это уровень доступа к действиям пользователя, отделенный ';' (VALUABLE ACCESS;SET STATUS;PHOTO CONTENT);

redirect_uri - адрес нашего сайта, куда вернется пользователь после авторизации.

После авторизации пользователь возвращается на наш сайт. Следующее действие - это получение access_token, с помощью которого мы сможем выполнять запросы к API.

Для получения access_token нам потребуется параметр code, который передается как параметр в момент переадресации пользователя на наш сайт.

Итак, выполняем наш C# POST метод. В качестве адреса указываем http://api.odnoklassniki.ru/oauth/token.do, а в качестве параметров: client_id={0}&client_secret={1}&code={2}&redirect_uri={3},
где

client_id - Application ID;
client_secret - Секретный ключ приложения;
code - параметр, получаемый из запроса  Request.QueryString["code"];
redirect_uri - адрес нашего сайта

Метод возвращает json, содержащий access_token. Json я десериализую в объект. Об этом писал здесь.

Теперь, зная access_token, можно делать запросы к API.

Допустим мы хотим обновить статус пользователя (не забываем для этого запросить уровень доступа SET STATUS).

Для выполнения запроса нам нужно сформировать цифровую подпись, являющуюся  MD5Hash-ем от конкатенации двух строк: access_token и секретного ключа приложения.

var sigSecret = GetMD5Hash(string.Format("{0}{1}", access_token,  client_secret ));

GetMD5Hash - метод получения Hash-a строки, о котором я писал ранее

Теперь выполняем полюбившийся уже нам  C# POST метод. В качестве адреса указываем http://api.odnoklassniki.ru/fb.do, а в качестве параметров: access_token={0}&method=users.setStatus&status=Новый статус&sig={1}, где

sig - MD5Hash от следующей строки: method=users.setStatusstatus=Новый статусsigSecret (sigSecret - значение, полученное ранее)

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