API

Добро пожаловать в API РуТвита

Что такое API РуТвита?

РуТвит API – это бесплатный программный интерфейс, который позволяет внешним приложениям и сервисам взаимодействовать с контентом РуТвита.

Вы можете без предварительного одобрения создать собственное приложение для тех пользователей интернета, которые имеют микроблог в РуТвите. Это может быть сайт, десктоп-приложение или клиент для iPhone, устройств на платформе Anroid или других мобильных телефонов. Что получится в результате зависит только от вашего мастерства и фантазии.

Как написать приложение с использованием РуТвит API?

1. Прочитайте раздел знакомство с API и изучите список методов в правой колонке.
2. Зарегистрируйте ваше приложение.
3. Реализуйте ваши идеи в собственном приложении.

Знакомство с API

Просто прочтите следующие разделы, которые помогут вам разобраться, как устроено API РуТвита, и написать собственное приложение.

Авторизация

Для доступа ко многим методам API необходима авторизация. API РуТвита поддерживает два способа авторизации – Basic Access Authentication и OAuth. Первый способ более простой в реализации, но при этом пароль пользователя передается в открытом виде. В связи с этим мы рекомендуем использование протокола авторизации OAuth.

API использует протокол HTTP

Взаимодействие с API происходит посредством HTTP запросов. Для получения информации о пользователях, твитах и результатах поиска используются GET запросы. Для отправки, изменения и удаления данных используются POST запросы.

REST API

Чтение данных осуществляется методом GET, изменение данных – методами POST и DELETE. Результаты запросов можно получать в любом из следующих форматов – xml, json, rss, atom. Подробнее...

Кодирование параметров

Некоторые функции API предполагают передачу параметров. Все передаваемые параметры должный иметь кодировку UTF-8 и быть url_encoded. Результат запроса также приходит в кодировке UTF-8.

Ограничение на запросы

Нельзя делать неограниченное количество запросов к РуТвит API. Это сделано для того, чтобы обеспечить стабильную работу сервиса и избежать спама и других нежелательных действий. Ограничение на количество запросов никак не влияет на добропорядочных пользователей и приложения.

Ограничение на получение данных

Для того чтобы поддержать быстроту и эффективность поиска, действует ограничение на количество твитов, выдаваемых в ответ на GET запросы поиска. Сейчас это ограничение – 1500 твитов.

API через командную строку

API можно использовать через командную строку. Если у вас установлен модуль Curl (а мы советуем его установить для вашего же удобства), то пример запроса выглядят следующим образом: curl -u user:password http://api.rutwit.ru/statuses/home_timeline.xml

Список методов

Список всех поддерживаемых методов вы можете увидеть в правой колонке. Чтобы узнать подробную информацию о каждом из них, нажмите на соответсвующую ссылку.

Если вам необходима поддержка методов, которые отсутсвуют в альфа-версии API, пожалуйста, напишите нам об этом. Мы планируем учитывать ваши пожелания при добавлении новой функциональности.

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