API TopSape
API представляет собой простой интерфейс для доступа к данным статистики. Вы можете использовать его для создания плагинов/виджетов, счетчиков дохода, позиции в рейтинге и т.д. Версия вторая, расширенная.Для доступа необходимо отправить HTTP-запрос по адресу http://topsape.ru/api.php
Необходимые параметры (порядок не важен):
id: идентификатор пользователя (можно узнать, кликнув по статистике пользователя)
act: выполняемое действие
format: формат вывода. XML по умолчанию, simple - простым текстом. Не обязательное поле. В списках можно использовать serialize
Запрос отправляется через GET-параметры. То есть, для того, чтобы узнать сегодняшний доход, нужно обратиться по этому адресу:
http://topsape.ru/api.php?act=today&id=ВАШ_id&format=simple
В ответ мы получим "345.34", или
<?xml version="1.0" encoding="UTF-8"?>
<topsape>
<id>ВАШ_id</id>
<today>345.34</today>
</topsape>
Функции:
Место в рейтинге
act=rank
Вывод: rank=позиция, change - изменение позиции со вчерашним днем
Доход за последний день
act=today
Вывод: today=доход
Данные за последний день
act=thisday
Вывод: today=доход, yest=вчерашний доход
ref=с рефов, refy=вчера с рефов
seo=расходы, seoy=вчерашние расходы
Использовать один этот запрос предпочительней, чем собирать данные по отдельным.
Данные для марафона
act=marafon
Вывод: marafon=стартовый доход участника (28.02.2010)
Статистика дохода по дням
act=days
| data= | Промежуток времени |
| last30 | последние 30 дней |
| last7 | последние 7 дней |
| all | все доступные данные |
| год | данные за год (2010,2009) |
| год-месяц | данные за месяц (2010-3, 2010-02 и т.д.) |
| год-месяц-день | данные за день (2010-3-2, 2010-03-02 и т.д.) |
| без промежутка | данные за последний день |
Формат вывода, по умолчанию: "Y-m-d|today|ref|seo\n"
При fromat=serialize - двумерный массив, упакованный с помощью serialize()
Полные данные доступны только за 2010 год, и только у пользователей использующих хеш. До этого времени могут быть неточности.
Текущие данные TopSape
act=topsape
limit=all (все данные) / число результатов
по умолчанию выдается первая страница (limit=30)
id указывать не нужно
Формат вывода, по умолчанию: "id|today|yest|ref|refy|seo|seoy\n"
При fromat=serialize - двумерный массив, упакованный с помощью serialize()
Теперь вы можете сделать свой топ, с блекджеком и ... :) Не забываем ставить ссылку на первоисточник.
Имя участника:
act=name
Вывод: name=имя, url=адрес блога, если есть
Примеры использования:
Вывод сегодняшнего дохода:
<?=file_get_contents("http://topsape.ru/api.php?act=today&id=ВАШ_id&format=simple");?>
<?
$str=file_get_contents("http://topsape.ru/api.php?act=rank&id=ВАШ_id&format=simple");
list($rank,$change)=explode("|",$str);
echo "Я $rank<sup>$change</sup> в рейтинге TopSape";
?>
<?
$id=1; //Ваш id (можно узнать в статистике)
$str=file_get_contents("http://topsape.ru/api.php?act=days&id={$id}&data=last30&format=serialize");
$arr=unserialize($str);
echo "<table border=1><tr><td>Дата<td>Доход<td>Рефы<td>Траты";
foreach ($arr as $v) {
$data=$v['data']; $today=$v['today']; $ref=$v['ref']; $seo=$v['seo'];
echo "<tr><td>$data<td>$today<td>$ref<td>$seo";
$alltoday+=$today; $allref+=$ref; $allseo+=$seo;
}
echo "<tr><td>Всего:<td>$alltoday<td>$allref<td>$allseo";
echo "</table>";
?>Статистика:
Запросов сегодня: 17684
Запросов вчера: 72965
Обращений за март: 725к