Instalar API eBesucher

El API de eBesucher permite acceder el servicio de estadísticas en el área de intercambio de visitas sin tener que iniciar sesión en el área de miembros. La API se puede utilizar con cualquier lenguaje de programación. La siguiente guía proporciona un ejemplo de código en PHP y se explica cómo utilizar cada función.

Requisitos

  • PHP 5.4.0
  • El uso del controlador de flujo de PHP asume que allow_url_fopen esté habilitado en php.ini el sistema.
  • El uso del manejador CURL requiere una versión actual de CURL delante de> = 7.16.2 zlib en conjunción con OpenSSL.
  • La API debe estar activada en el área de usuarios bajo Datos del usuario y API.

Instalación

Para instalar Guzzle se debe utilizar Composer. Con el compositor de paquetes y dependencias puede administrar el software en PHP. Compositor los instala en su proyecto.

  Install Composer

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

Usted puede añadir Guzzle con la ayuda de la CLI composer.phar como una dependencia:

php composer.phar require guzzlehttp / tragan: 5.0 ~

Después de la instalación, se debe ejecutar el comando de solicitud de compositor de cargador automático:

require 'vendor/autoload.php';

Inicio rápido (Creación de un cliente)

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'));

Respuestas (JSON) + cadena de consulta

o se necesita autorización

IP

IPv4 Dirección erhalten IP4 es zurückgesendet

print_r ($ cliente-> get ( 'ip.json / dirección') -> JSON ());

Respuesta

10.0.0.1

Obtenga información sobre la IP solicitada Adresse

Este método envía una matriz con información sobre la dirección IP de la solicitud de la que se origina. Se incluyen los datos siguientes: dirección IP, nombre de host, código de país del país en el que la dirección IP se va a ubicar, y el nombre completo del país.

print_r ($ cliente-> get ( 'ip.json / datos') -> JSON ());

Respuesta:

 Array

 (
    [Ip] => 10.0.0.1
    [Host] => 10-0-0-1.hostname.de
    [countryCode] => ES
    [countryName] => España
 )

Se requiere autorización

Cuenta

Elabore un informe Crear un informe de estadísticas de ganancias para cualquier período de tiempo. El informe contiene el número de puntos obtenidos para cada enlace de surf. El informe se calcula de forma asíncrona. Por tanto, los resultados deben ser solicitados con un retraso de 5 a 10 minutos.

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"; }

Respuesta:

814

Descargue un informe ya creado

Aviso: El informe no se almacena permanentemente. 12 horas después de la creación de un informe, este se puede eliminar del servidor.

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

Respuesta:

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

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

Obtenga el estado actual de un informe

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

Respuesta:

Array

(

[Id] => 814
[UserID] => 714619
[De] => 1424690754
[A] => 1424777156
[Progreso] => 100
[Tipo] => visit_earnings
[Isfinished] => 1
[From_w3c] => 2015-02-23T11: 25: 54 + 00: 00
[To_w3c] => 2015-02-24T11: 25: 56 + 00: 00

)

Elimine un informe ya creado

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

Respuesta:

1

Obtenga todas las estadísticas de ganancias de una cuenta

Lograr una estadísticas generales sobre el número de puntos obtenidos en los diferentes períodos de tiempo.

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

Respuesta:

 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
        )
     ...
)

Obtenga una estadística de ganancias por hora

Estadísticas totales (suma de todos los enlaces de navegación de una cuenta) para un día determinado. La cantidad de puntos ganados por hora se muestra del 1 al 24.

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

Respuesta:

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

Surflink

Reciba los enlaces de navegación usados activeSince: (opcional), obtenga solo los enlaces de navegación que se usaron dentro de una ventana de tiempo (formato de hora Unix).

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

Respuesta:

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
        )
       ...
 )

Reciba estadísticas de ganancias de un enlace de navegación en particular Obtenga una estadística sobre el número de puntos ganados de un Surflink, dentro de diferentes períodos de tiempo.

$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();}

Respuesta:

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
       )
    ...
)

Recibir estadísticas de ganancias por hora

Recibe estadísticas de ganancias por hora para un surflink determinado y una fecha específica. La cantidad de puntos ganados por hora se muestra del 1 al 24.

$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(); }

Respuesta:

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

Compartir configuraciones de un enlace de navegación

Permite al usuario acceder a la configuración de las páginas mostradas en su enlace de navegación. Opcionalmente, la validez de los enlaces de navegación puede estar limitada en el tiempo.

Surflink über die API teilen

Preguntas frecuentes

¿Cuántas consultas de API están disponibles?

El número de consultas Api se calcula por hora y depende del estado de la cuenta. La información se puede encontrar en Formulario Premium.

¿Dónde puedo ver cuántas consultas de API están disponibles actualmente?

Para cada consulta, el límite asociado y las solicitudes restantes restantes se devuelven como encabezados HTTP: (ver "Encabezados de respuesta" en el API Explorer).

[..]
—> 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
[..]

Preguntas frecuentes para usuarios