trafic.ro

Top 1000

Descriere | Rezultat

Această metodă întoarce o listă cu primele site-uri din top 1000 vizitatori unici pentru toate categoriile sau pentru categoria furnizată ca parametru.
Este disponibilă din versiunea API 0.02.

Nume metodă

getTop1000 ( [integer pagina] , [string cat_name] )

Parametrii

pagina integer - pagina din top dorită.

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 Top1000ReturnArray, în care fiecare element este un obiect de tipul Top1000Return.

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

  • site - string
  • identificator_site - string
  • pozitie_in_categorie - integer
  • pozitie_in_clasamentul_general - integer
  • vizitatori - integer
  • vizite - integer
  • afisari - integer
  • descriere - string
  • sati - integer

Informații suplimentare:

  • date - string
  • pagina_curenta - integer
  • pagini_disponibile - integer
  • nr_siteuri_intoarse - integer
  • categoria - string

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.02/trafic.wsdl',
	array('soap_version' => SOAP_1_2)
	);

$categoryIdentifier = 'bloguri';

/**
 * Se ciclează pe Top1000ReturnArray
 */
foreach ($sc->getTop1000( 1 , $categoryIdentifier) as $t)
{
	/**
	 * $t este un obiect
	 * de tipul Top1000Return
	 */
	echo 'pozitie clasament general: ', $t->pozitie_in_clasamentul_general,
		" | vizitatori: ", $t->vizitatori,
		" | vizite: ", $t->vizite,
		" | afisari: ", $t->afisari,
		" | site: ", $t->site,
		PHP_EOL;
}					

Nume metodă

top1000[pagina/identificator-categorie]

Parametrii

pagina string - pagina din top dorită. (de forma: pag-1)

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

Răspuns

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

top1000
elementul rădăcină al documentului XML;
item
element ce defineşte un site în top, poate apărea numai în elementul top1000;
site
URL-ul siteului;
identificator_site
identificatorul unic al siteului;
pozitie_in_clasamentul_general
poziţia în clasamentul general din trafic.ro;
pozitie_in_categorie
poziţia în clasamentul pe categorie din trafic.ro;
vizitatori
numărul de vizitatori unici;
vizite
numărul de vizite;
afisari
numărul de afişări;
descriere
descrierea siteului.
sati
0 - pentru siturile înscrise în trafic.ro sau 1 pentru siteurile înscrise în SATI.

Informații suplimentare:

date
clasamentul din care se aduc datele;
pagina_curenta
pagina curentă;
nr_siteuri_intoarse
numărul de siteuri disponibile;
pagini_disponibile
pagini disponibile;
categoria
categoria aleasă;

Exemplu

Pentru a vizualiza documentul intors de această metodă accesaţi: api.trafic.ro/rest/0.02/top1000/pag-1/bloguri

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

<?php

$categoryIdentifier = 'bloguri';

$address = 'http://api.trafic.ro/rest/0.02/top1000/pag-1/' . $categoryIdentifier;

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

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

Rezultat

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