trafic.ro

Vizitatori

Descriere | Rezultat

Această metodă întoarce o listă (max. 5 elemente) cu numărul vizitatorilor unici pentru un site activ in fuctie de intervalul selectat.

Nume metodă

getVizitatori ( [string interval] , [string site] )

Parametrii

interval string - interval întors de apelul la metoda Intervale.

site string - identificatorul unic al siteului (ex: http://stat.trafic.ro/stat/okazii).

Răspuns

La apelarea metodei SOAP veţi primi drept răspuns un array de tip VizitatoriReturnArray, în care fiecare element este un obiect de tipul VizitatoriReturn.

Fiecare obiect de tip VizitatoriReturn are următoarele proprietăţi:

  • data - string
  • vizitatori_unici - integer

Exemplu

Următorul script PHP oferă un exemplu de implementare:

<?php

/**
 * Se crează o instanţă SoapClient
 */
$sc = new SoapClient('http://'
			. 'api.trafic.ro'
			. '/soap/0.01/trafic.wsdl',
	array('soap_version' => SOAP_1_2)
	);

$interval = 'luna';
$site = 'okazii';

/**
 * Se ciclează pe AcceptedIntervalArray
 */
foreach ($sc->getVizitatori($interval, $site) as $t)
{
	/**
	 * $t este un obiect
	 * de tipul VizitatoriReturn
	 */
	echo 'data: ', $t->data,
		"\t | vizitatori unici: ", $t->vizitatori_unici,
		PHP_EOL;
}					

Nume metodă

vizitatori[/inteval/identificator-site]

Parametrii

interval - interval întors de apelul la metoda Intervale.

identificator-site - identificatorul unic al siteului (ex: http://stat.trafic.ro/stat/okazii).

Răspuns

Întoarce un document XML. Cu următoarele elemente:

vizitatori
elementul rădăcină al documentului XML;
item
element ce defineşte un site în top, poate apărea numai în elementul top10;
data
data pentru care se afiseaza vizitatorii unici;
vizitatori_unici
numărul de vizitatori unici;

Exemplu

Pentru a vizualiza documentul intors de această metodă accesaţi: api.trafic.ro/rest/0.01/vizitatori/zi/okazii

Următorul script PHP oferă un exemplu de implementare:

<?php

$interval = 'luna';
$siteIdentifier = 'okazii';

$address = 'http://api.trafic.ro/rest/0.01/vizitatori/'. $interval. '/' . $siteIdentifier ;

/**
 * Se creează un obiect de tip SimpleXML
 */
$doc = simplexml_load_file($address);

/**
 * Se ciclează pe toti copii elementului 'vizitatori'
 */
foreach ($doc->item as $t)
{
	echo 'data: ', $t->data,
		" | vizitatori unici: ", $t->vizitatori_unici,
		PHP_EOL;
}					

Rezultat

Ambele secvenţe de cod PHP (SOAP/REST) vor afişa: