Установить интерфейс программирования приложений eBesucher API

Интерфейс программирования приложений eBesucher-API позволяет получать статистику заработанных в автосёрфинге пунктов, не входя в аккаунт. API можно использовать с разными языками программирования. Данное руководство содержит пример кода на языке PHP и объясняет использование отдельных функций.

Требования

  • PHP 5.4.0
  • Использование PHP stream handler предполагает, что в системном файле php.ini активирован пункт allow_url_fopen .
  • Использование cURL handler предполагает последнюю версию cURL >= 7.16.2 в сочетании с OpenSSL и zlib.
  • Интерфейс программирования приложений должен быть активирован в Зоне пользователя по адресу Данные пользователя и API .

Установка

Для установки Guzzle следует использовать Composer. При помощи Composer можно управлять пакетами и зависимостями в программе PHP. Composer установит их в Ваш проект.

Install Composer

curl -sS https://getcomposer.org/installer | php

Вы можете добавить Guzzle при помощи composer.phar CLI в качестве зависимости:

php composer.phar require guzzlehttp/guzzle:~5.0

После установки должна быть запущена функция require в Composer autoloader:

require 'vendor/autoload.php';

Быстрый запуск (Создание учётной записи) / Quickstart (Creating a Client)

chdir(dirname(__DIR__));

require_once 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client(array('base_url' => 'https://www.ebesucher.de/api/'));

$option = array('auth' => array('YOUR_LOGIN', 'YOUR_API_KEY'));

Responses (JSON) + Query String

Авторизация не требуется

IP

IPv4-адрес получен IP4 отправлен

print_r($client->get('ip.json/address')->json());

Ответ:

10.0.0.1

Получить информацию о запрошенном IP-адресе

При использовании этого метода отправляется массив с информацией о IP-адресе, а именно к какой функции request он относится. Запрос содержит следующие данные: IP-адрес, имя хоста, код страны, в которой находится местоположение IP-адреса, а также полное название страны.

print_r($client->get('ip.json/data')->json());

Ответ:

Array

(
    [ip] => 10.0.0.1
    [host] => 10-0-0-1.hostname.de
    [countryCode] => DE
    [countryName] => Deutschland
)

Необходима авторизация

Аккаунт

Создание отчёта Создайте отчёт со статистикой заработка за любой промежуток времени. Отчёт содержит количество заработанных пунктов для каждой ссылки серфинга. Отчёт создаётся асинхронно. Поэтому результаты могут быть запрошены с задержкой в 5-10 минут.

eBesucher API

$option['query'] = array('from' => '141100000', 'to' => '142200000');
try { print_r($client->post('visitor_exchange.json/account/surflink_earnings_report', $option)->json())."\n"; } catch (Exception $e){ echo $e->getMessage()."\n"; }

Ответ:

814

Загрузка уже созданного отчёта

Примечание: Отчёт не сохраняется длительное время. По просшествии 12 часов он может быть удалён с сервера.

$reportId = 814;
try { print_r($client->get("visitor_exchange.json/account/surflink_earnings_report/".$reportId,
$option)->json());} catch (Exception $e){ echo $e->getMessage(); }

Ответ:

Array
(
    [0] => Array
        (
            [surflinkID] => 288987
            [value] => 4484.900000
        )

    [1] => Array
        (
            [surflinkID] => 289092
            [value] => 7343.790000
        )
    ...
)

Запросить актуальный статус отчёта

$reportId = 814;
try { print_r($client->get("visitor_exchange.json/account/surflink_earnings_report/".$reportId."/status",
$option)->json()); } catch (Exception $e){ echo $e->getMessage(); }

Ответ:

Array 

(

    [id] => 814
    [userID] => 714619
    [from] => 1424690754
    [to] => 1424777156
    [progress] => 100
    [type] => visit_earnings
    [isFinished] => 1
    [from_w3c] => 2015-02-23T11:25:54+00:00
    [to_w3c] => 2015-02-24T11:25:56+00:00

)

Удалить уже созданный отчёт

 $reportId = 814;
 try { print_r($client->delete("visitor_exchange.json/account/surflink_earnings_report/".$reportId,
 $option)->json());} catch (Exception $e){ echo $e->getMessage(); }

Ответ:

1

Получить общую статистику заработка для аккаунта

Получайте общую статистику заработанных пунктов за определённый периоод времени.

$date = array('from'=> 1415743232,'to'=> 1416520832);
print_r($client->get("visitor_exchange.json/account/earnings/".$date['from']."-".$date['to'],
$option)->json());

Ответ:

Array
(
    [0] => Array
        (
            [from] => 1424689202
            [from_w3c] => 2015-02-23T11:00:02+00:00
            [to] => 1424692799
            [to_w3c] => 2015-02-23T11:59:59+00:00
            [value] => 1987.200000
        )

    [1] => Array
        (
            [from] => 1424692801
            [from_w3c] => 2015-02-23T12:00:01+00:00
            [to] => 1424696399
            [to_w3c] => 2015-02-23T12:59:59+00:00
            [value] => 1384.000000
        )
    ...

)

Получить почасовую статистику заработанных пунктов

Общая статистика (Сумма всех ссылок для сёрфинга одного аккаунта) за один день. Выдаётся статистика заработанных пунктов за каждый час в течении дня.

$date="2015-02-19";
$option['query'] = array('timezone' => 'Europe/Berlin');
print_r($client->get("visitor_exchange.json/account/earnings_hourly/".$date,
$option)->json());

Ответ:

Array
(
    [1] => 3009.6
    [2] => 2753.6
    ...
)

Ссылка для сёрфинга

Получить все используемые ссылки для сёрфинга activeSince : (опционально), получить только те ссылки для сёрфинга, которые были использованы в течении определённого периода времени (unix time format).

$option['query'] = array('activeSince' => 1424690754);
print_r($client->get("visitor_exchange.json/surflinks", $option)->json());

Ответ:

Array
(
    [0] => Array
        (
            [id] => 347876
            [fullName] => YOUR_LOGIN.surflink1
            [url] => http://www.ebesucher.de/surfbar/YOUR_LOGIN.surflink1
            [lastActivity] => 2015-02-24 11:59:17
        )

    [1] => Array
        (
            [id] => 347764
            [fullName] => YOUR_LOGIN.surflink2
            [url] => http://www.ebesucher.de/surfbar/YOUR_LOGIN.surflink2
            [lastActivity] => 2015-02-24 11:51:54
        )
    ...
)

Получить статистику заработанных пунктов для одной ссылки для сёрфинга Получить статистику количества заработанных пунктов для одной ссылки для сёрфинга за определённый период времени.

$data = array('surflinkName'=>'YOUR_LOGIN.surflink1','from'=>1424604354,'to'=>1424690754);
try { print_r($client->get("visitor_exchange.json/surflink/"
.$data['surflinkName']."/earnings/".$data['from']."-".$data['to'],
$option)->json()); } catch (Exception $e){ echo $e->getMessage();}

Ответ:

Array
(
    [0] => Array
        (
            [from] => 1424602861
            [from_w3c] => 2015-02-22T11:01:01+00:00
            [to] => 1424606399
            [to_w3c] => 2015-02-22T11:59:59+00:00
            [value] => 362.140000
        )

    [1] => Array
        (
            [from] => 1424606549
            [from_w3c] => 2015-02-22T12:02:29+00:00
            [to] => 1424609999
            [to_w3c] => 2015-02-22T12:59:59+00:00
            [value] => 240.800000
        )
    ...
)

Получить почасовую статистику заработанных пунктов

Получите почасовую статистику заработаных пунктов для одной ссылки для сёрфинга за определённый день. Выдаётся количество заработанных пунктов за каждый час в течении дня.

$data=array('surflinkName'=>'YOUR_LOGIN.test','date'=>'2015-02-22');
$option['query'] = array('timezone' => 'Europe/Berlin');
try {print_r($client->get("visitor_exchange.json/surflink/"
.$data['surflinkName']."/earnings_hourly/".$data['date'],
$option)->json());} catch (Exception $e){ echo $e->getMessage(); }

Ответ:

Array
(
    [1] => 334.4
    [2] => 347.2
    [3] => 224
    [4] => 356.8
    [5] => 358.4
    ...
)

Поделиться настройками ссылки для сёрфинга

Дайте возможность пользователю получить доступ к настройкам показываемых страниц через ссылку для сёрфинга. Опционально Вы можете ограничить срок действия ссылки для сёрфинга.

Surflink über die API teilen

Часто задаваемые вопросы

Сколько API-запросов мне доступно?

Количество доступных API-запросов рассчитывается на час и зависит от статуса аккаунта. Более подробную информацию Вы найдёте здесь Premium Formular.

Где я могу посмотреть, сколько API-запросов у меня ещё осталось?

При каждом запросе Вам показывается оставшееся количество запросов в заголовке HTTP: (смотрите в API-Explorer "Response Headers")

[..] —> X-RateLimit-Remaining: 999 X-Auth-Status: true Content-Language: en-US Cache-Control: no-cache, must-revalidate Transfer-Encoding: chunked -> X-RateLimit-Limit: 1000 per hour [..]


FAQ для пользователей

Обмен посетителями

Обмен письмами

Объявления-клики

Привлечь друзей

Нарушение правил

Интерфейс программирования приложений eBesucher API

Другое