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, нам необходимо обратиться по адресу.



В это случае, мы говорим, что обращаемся к объекту 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, т.е. адрес будет выглядеть следующим образом



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


Ответ в виде JSON

Для того, чтобы получать ответы от сервера в формате JSON, достаточно приписать к адресу запроса format=json, например.


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

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

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