Введение

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

Авторизация

API использует авторизацию по протоколу OAuth 2.0, с помощью которого можно получить разрешение на работу с личными данными (записями, фотографиями, и т. д.) пользователей Моего Круга. При этом доступны профили только тех пользователей сервиса, которые это явным образом разрешили.

Общая схема взаимодействия приложения с OAuth-сервером представлена на странице Процедура авторизации.

Информация о пользователе принимается в виде авторизационного токена в HTTP-заголовке Authorization. Также авторизационный токен может передаваться с помощью параметра oauth_token. При обращении без авторизационного токена к данным пользователя будет возвращен HTTP-статус 401 Unauthorized.

Как работает API

API Моего Круга реализовано на REST-принципах (Representational State Transfer) с использованием HTTP, XML и JSON для обмена данными.

Доступ к API осуществляется по протоколу HTTP, все доступные на данный момент адреса ресурсов API вызываются с помощью HTTP-метода GET.

API Моего Круга доступен для пользователей по адресу:

http://api.moikrug.ru/v1/

О документации

Руководство содержит описание программного интерфейса (API) к сервису Яндекс.МойКруг.

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

Информация, представленная в руководстве, актуальна на июль 2011 года.