Последние записи сайта "Я-русский" интересны не только простым читателям, но и нашим коллегам — web-разработчикам, мастерам и программистам. Чтобы получить краткие сведения о последних постах iamruss.ru можно воспользоваться двумя способами:
- открыть RSS-ленту по адресу http://iamruss.ru/feed/
- воспользоваться API (англ. application programming interface, API [эй-пи-ай]) - интерфейс программирования приложений или интерфейс прикладного программирования
И если с лентой все понятно, то по API дадим краткое пояснение.
Само API не подразумевает широких возможностей по работе с контентом этого сайта, а реализует получение базовой актуальной информации - названий, анонсов и адресов последних 10 статей. Оно представлено набором статичных файлов и двумя протоколами: XML-RPC и SOAP. Каким бы API вы ни пользовались, получаемый ответ будет в четырех форматах: json, xml, html, javascript.
Разница между статикой и xml-rpc в том, что статичные файлы обновляются один раз в час, а доступ по протоколу вызова удалённых процедур позволяет отслеживать появление материалов в режиме реального времени.
Статичные файлы
Расположены они по следующим адресам:
- json = http://iamruss.ru/oldapi/feed.json
- xml = http://iamruss.ru/oldapi/feed.xml
- html = http://iamruss.ru/oldapi/feed.html
- javascript = http://iamruss.ru/oldapi/feed.js
Для использования версии javascript, вставьте в нужном месте своего сайта вот этот код:
<script src="http://iamruss.ru/oldapi/feed.js"></script>
и ниже его будет выведен html-код.
p.s. Файлы feed.html и feed.js могут кешироваться сервером.
XML-RPC
Обращение к xml-rpc серверу необходимо осуществлять методом POST. Адрес сервера: http://iamruss.ru/api/xml-rpc/server.php. Существует единственный метод который позволяет получить ответ сервера - lastContent (). Ниже приводится пример кода xml-rpc клиента на языке php
<?php header("Content-Type: text/xml; charset=utf-8"); header("Cache-Control: no-store, no-cache"); header("Expires: ".date("r")); $request = xmlrpc_encode_request("lastContent",array()); $context = stream_context_create(array('http' => array( 'method' => "POST", 'header' => "Content-Type: text/xml\r\nUser-Agent: PHPRPC/1.0\r\n", 'content' => $request ))); $server = 'http://iamruss.ru/api/xml-rpc/server.php'; $file = file_get_contents($server, false, $context); $response = xmlrpc_decode($file); echo $response;По всем вопросам связанным с API просьба обращаться по адресу devel-iamruss@yandex.ru
SOAP
Адрес сервера: http://iamruss.ru/api/soap/server.php.
Как и в случае с XML-RPC, существует единственный метод который позволяет получить ответ сервера - lastContent (), возвращающий данные о последних статья в четырех форматах: json, xml, html, javascript. По-умолчанию ответом будет xml. Ниже приводится пример кода soap клиента на языке php
<?php $options = array( 'location' => 'http://iamruss.ru/api/soap/server.php', 'uri' => 'http://iamruss.ru/api/soap/' ); $api = new SoapClient(NULL, $options); echo $api->lastContent();
Яндекс Виджет
Также вы можете установить виджет с последними записями сайта "Я-русский" на главную страницу Яндекса в своем браузере. Дл я этого прейдите по этой ссылке //www.yandex.ru/?add=172892&from=promocode и выберите место где он будет располагаться.
Удачного чтения!
Материал создан: 03.03.2016
