trafic.ro

Top 10

Descriere | Rezultat

Această metodă întoarce o listă cu primele site-uri din top 10 vizitatori unici pentru toate categoriile sau pentru categoria furnizată ca parametru.

Nume metodă

getTop10 ( [string cat_name] )

Parametrii

cat_name string - un identificator unic de categorie întors de apelul la metoda categorii.

Răspuns

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

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

  • afisari - integer
  • pozitie - integer
  • sati - integer
  • site - string
  • vizitatori - integer
  • vizite - 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)
	);

$categoryIdentifier = 'bloguri';

/**
 * Se ciclează pe AcceptedIntervalArray
 */
foreach ($sc->getTop10($categoryIdentifier) as $t)
{
	/**
	 * $t este un obiect
	 * de tipul Top10Return
	 */
	echo 'pozitie: ', $t->pozitie,
		"\t | vizitatori: ", $t->vizitatori,
		"\t | vizite: ", $t->vizite,
		"\t | afisari: ", $t->afisari,
		"\t | site: ", $t->site,
		PHP_EOL;
}					

Nume metodă

top10[/identificator-categorie]

Parametrii

identificator-categorie - un identificator unic de categorie întors de apelul la metoda categorii.

Răspuns

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

top10
elementul rădăcină al documentului XML;
item
element ce defineşte un site în top, poate apărea numai în elementul top10;
site
URL-ul siteului;
vizitatori
numărul de vizitatori unici;
vizite
numărul de vizite;
afisari
numărul de afişări;
pozitie
poziţia în topul trafic.ro;
sati
0 - pentru siturile înscrise în trafic.ro sau 1 pentru siteurile înscrise în SATI.

Exemplu

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

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

<?php

$categoryIdentifier = 'bloguri';

$address = 'http://api.trafic.ro/rest/0.01/top10/' . $categoryIdentifier;

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

/**
 * Se ciclează pe toti copii elementului 'top10'
 */
foreach ($doc->item as $t)
{
	echo 'pozitie: ', $t->pozitie,
		"\t | vizitatori: ", $t->vizitatori,
		"\t | vizite: ", $t->vizite,
		"\t | afisari: ", $t->afisari,
		"\t | site: ", $t->site,
		PHP_EOL;
}					

Rezultat

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