API Scribbler.ru

Программный интерфейс приложения (или API, "application programming interface") - это инструмент, позволяющий разработчикам получать доступ к частям сайта Scribbler.ru и интегрировать их в собственный сайт, создавать приложения, как внутри сайта, так и стороние.

API сайта Scribbler.ru реализован, как и на большинстве популярных ресурсов(facebook.com, twitter.com и т.д.) на архитектуре использующей идеологию REST.

REST описывает архитектуру парадигмы для web—приложений которые запрашивают и манипулируют web—ресурсами, используя стандартные HTTP методы GET и POST.

Пример:

Допустим, в том случае когда мы хотим узнать, информацию о своем аккаунте, на сайте Scribbler.ru, нам необходимо обратиться по адресу

http://scribbler.ru/api/rest/user.getInfo.

В это случае, мы говорим, что обращаемся к объекту user и используем его метод getInfo. В ответ мы получим XML следующего вида:

<restResponse object="user" method="getInfoAction">
<id>12313546</id>
<fullName>Василий Пупкин</fullName>
<nick>Vasyok</nick>
<isOnline>yes</isOnline>
<type>student</type>
<smallAvatar>http://scribbler.ru/uploaded/avatar/user/12313546/small.jpg</smallAvatar>
<mediumAvatar>http://scribbler.ru/uploaded/avatar/user/12313546/medium.jpg</mediumAvatar>
<userPic>http://scribbler.ru/uploaded/avatar/user/12313546/big.jpg</userPic>
</restResponse>

А в случае, если мы передадим параметр userId, используюя метод GET, т.е. адрес будет выглядеть следующим образом

http://scribbler.ru/api/rest/user.getInfo?userId=10

То в ответ мы получим XML с такой же структурой, но с данными пользователя, ID которого 10.

Ответ в виде JSON

Для того, чтобы получать ответы от сервера в формате JSON, достаточно приписать к адресу запроса format=json, например, http://scribbler.ru/api/rest/user.getInfo?userId=10&format=json.

Объекты Scribbler.ru API.

На данный момент API находится в стадии разработки, и реализованы не все объекты с которыми можно будет работать.

На сегодняшний день существуют следующие объекты:
application - Приложение
bench - Скамейка
comment - Комментарии
dataStorage - Хранилище данных(для приложений)
mail - Почта
photo - Фотографии
server - Данные сервера
user - Пользователь
stream - Лента активности
blogRecord - Посты в блогах
community - Сообщества
desktop - Работа с файлами рабочего стола