Anuntul Online - Aplicatie transfer

Web Service

1. Introducere

online.anuntul.ro ofera un Web Service bazat pe protocolul SOAP.

2. Accesul online.anuntul WS

Accesul autorizat se poate obtine prin completarea acestui formular specificandu-se urmatoarele informatii: adresa de email a contului de pe online.anuntul.ro; numele firmei sau a persoanei pentru care s-a creat contul respectiv; numar de telefon si persoana de contact

3. Cerinte

Este necesar un client SOAP indiferent de limbajul ales, iar pentru PHP este necesar PHP 5 >= 5.0.1

4. Exemplu de implementare in limbaj PHP

Vezi exemplu complet in client.php

Se defineste URL-ul WSDL http://online.anuntul.ro/ws/server.php?wsdl

Se introduce utilizatorul si parola.

Apelarea metodei $client->login($credentials); va realiza autentificarea si va permite accesul la Web Service. Fara apelarea aceastei metodei nu se poate realiza nicio operatiune.

Lista completa a categoriilor conform Anuntul Online poate fi gasita aici.
Lista completa a judetelor conform Anuntul Online poate fi gasita aici.

Adaugarea anuntului se face prin apelarea metodei $client->adaugaAnunt($anuntAO); unde $anuntAO este un obiect de tip anunt ( $anuntAO = new SoapParam($anunt, 'anunt'); )

anunt.class.php prezinta structura clasei anunt. Nu este necesara includerea acestei clase in codul dumneavoastra. Campurile marcate cu @obligatoriu, vor fi obligatoriu necesar completate.

O situatie aparte o reprezinta utilizarea campurilor aditionale. O parte din categoriile Anuntul Online necesita completarea unor campuri aditionale. de ex: Pentru categoria Electronice, electro. > Computere, laptopuri > Laptopuri este necesara completarea a doua campuri aditionale: marca si starea laptop-ului.
Acest lucru se poate realiza in urmatorul mod:

$campuri_aditionale[262] = "Acer";
$campuri_aditionale[224] = "nou";
$anunt -> campuri_aditionale = serialize($campuri_aditionale);

unde 262 si 224 reprezinta ID Camp Marca respectiv ID Camp Stare.

Campurile cu [type] => select_multiple sau [type] => checkbox permit valori multiple. Acestea lucru se realizeaza folosind un array de valori in locul unei singure valori:

$campuri_aditionale[237] = array("XS (34)","M (38-40)","XXL (50-54)");
$anunt -> campuri_aditionale = serialize($campuri_aditionale);

Lista completa a campurilor specifice fiecarei categorii poate fi gasita aici.

Imaginiile anunturilor se vor trimite sub forma de link complet cu acces public.

Dupa completarea cel putin a campurilor obligatorii, se poate adauga anuntul pentru Anuntul Online. Adaugarea se va realiza prin apelarea metodei $id_anunt = $client->adaugaAnunt($anuntAO); unde $anuntAO = new SoapParam($anunt, 'anunt'); , $anunt fiind obiectul nou creat al clasei anunt. In caz favorabil, anuntul va fi adaugat, si metoda la returna ID anuntului, care poate fi salvat pentru referinte ulteriore (operatiuni de push up, stergere etc.)

Exemplul 2 ilustreaza modul de executie a unui push up avand un ID anunt dat.

5. Restrictii

Anuntul Online WS permite adaugarea a maxim 1 anunt / minut. Pentru adaugarea de volum mare, recomandam utilizarea unui sistem bazat pe cron job.

Toate campurile marcate cu @obligatoriu in anunt.class.php sunt obligatorii oricarui anunt indiferent de categoria aleasa.

Toate campurile aditionale (unde este cazul) apartinand categoriei alese sunt optionale.

Un anunt poate avea maxim 8 imagini.

client.php

<?php


define("WSDL", "http://online.anuntul.ro/ws/server.php?wsdl");
define("USERNAME", "contul dvs online.anuntul.ro");
define("PASSWORD", "parola contului");

//verificam existenta clasei SoapClient
if (!class_exists('SoapClient')) {
    die ("Nu aveti extensia PHP-SOAP instalata.");
}
 
$soap_options = array('cache_wsdl' => WSDL_CACHE_NONE,'trace'=>true);
$credentials = array('username'=>USERNAME, 'password'=>md5(PASSWORD));

$client = new SoapClient(WSDL,$soap_options);
$autenficat = $client->login($credentials);



 if( $autenficat  ) {
	 
	//Exempul 1. Adaugare anunt in categoria Computere, sectiunea Laptop-uri 
	
	$anunt = new StdClass();
	
	//ID anunt (sau ID produs) in sistemul dumneavoastra
	$anunt -> id_anunt_intern = 14;
		 
	$anunt -> categorie = 'Accesorii Tablete > Acumulatori Tablete';;
	
	$campuri_aditionale[262] = "Acer";
	$campuri_aditionale[224] = "nou";
	
	
	$anunt -> campuri_aditionale = serialize($campuri_aditionale);
	
	$anunt -> tip_vanzator = 1; 
	$anunt -> titlu = 'laptop DELL performant';  
	$anunt -> text_anunt = 'Vand cel mai performant laptop DELL al momentului, INSPIRON 17000, la un pret incredibil de mic.';
	$anunt -> descriere = 'Detalii la telefon';
	$anunt -> pret = 2000.55;
	$anunt -> pret_nou = 1900.55;
	$anunt -> pana_cand = strtotime('+1 day');  
	$anunt -> um = 'buc';  
	$anunt -> moneda = 1;  
	
	$anunt -> idjud = $client->getIDJudet('Arad'); 
	if( $anunt -> idjud != 10 ) {
		$anunt -> localitate_id = $client->getLocalitate($anunt -> idjud,'Arad');
		
	}
	
	$anunt -> strada = 'Blvd. Elisabete';  
	$anunt -> nr_strada = '21A';  
	$anunt -> lat = 44.434798;  
	$anunt -> lng = 26.095669;  
	$anunt -> subzona = '';
	$anunt -> email = 'email@email.ro';  
	$anunt -> not_display_email = 0;  
	$anunt -> site = 'www.exemplu.ro';  
	$anunt -> telefon1 = '0720000000';  
	$anunt -> telefon2 = '0720000001'; 
	
	
	$anunt -> youtube_url = 'http://www.youtube.com/watch?v=bbAO4ICmwYk';  
	
	
	$anunt -> link_produs = 'http://www.siteulmeu.ro/pagina-detalii-produs';  
	$anunt -> imagini = array( 'http://www.downloadprograme.ro/wp-content/uploads/2010/07/3-D-66.jpg'
				  ,'http://www.downloadprograme.ro/wp-content/uploads/2010/07/12340.jpg'
				  ); 
	
	$anuntAO = new SoapParam($anunt, 'anunt'); 
 
	try {
		
		 //puteti salva $id_anunt in baza dvs. de date pentru referinte ulterioare
		 $id_anunt = $client->adaugaAnunt($anuntAO);
		 
		
		
		 if( $id_anunt > 0 ) {
				echo "Anuntul a fost adaugat cu succes! Are ID: ".$id_anunt; 
		 }
	 
	} catch (SoapFault $eroare) {
			echo "Eroare SOAP: (Cod: {$eroare->faultcode}, Mesaj: {$eroare->faultstring})";
		}

	
	

  	//Exemplul 2. Folosirea optiunii de push UP
	try {
		
		 if (  $client->pushUp($id_anunt) ) {
				echo "<br>Valabilitatea anuntului a fost prelungita."; 
		 }
		 
	} catch (SoapFault $eroare) {
		echo "Eroare SOAP: (Cod: {$eroare->faultcode}, Mesaj: {$eroare->faultstring})";
	}
	
	
	 $client->logout();
	 
	}

?>

anunt.class.php doar informativ, nu este necesara includerea clasei in client.php

<?php

class anunt
{


    /**
     * ID anunt in sistemul Anuntul Online
     * @var int
     *
     */
    public $id_anunt;

    /**
     * ID anunt (sau ID produs) in sistemul dumneavoastra
     * @var int
     *
     */
    public $id_anunt_intern;

    /**
     * ID user
     * @var int
     *
     */
    public $iduser;

    /**
     *
     * Numele complet al categoriei din care face parte anuntul, ex: Accesorii Tablete > Acumulatori Tablete
     * @obligatoriu
     * @var string
     *
     */
    public $categorie = "";

    /**
     *
     * nu trebuie completat
     * @var int
     *
     */
    public $id_categorie = 0;

    /**
     * nu trebuie completat
     * @var int
     *
     */
    public $id_sectiune;

    /**
     * Tip vanzator, valori posibile:
     * 1 = Particular
     * 2 = Firma
     * @obligatoriu
     * @var int
     *
     */
    public $tip_vanzator = '';


    /**
     * Titlu, permite maxim 30 de caractere
     * @obligatoriu
     * @var string
     *
     */
    public $titlu = '';

    /**
     * Text anunt, permite minim 40 de caractere, maxim 200 de caractere
     * @obligatoriu
     * @var string
     *
     */
    public $text_anunt = '';

    /**
     * Descriere, permite maxim 1000 de caractere
     * @var string
     *
     */
    public $descriere = '';

    /**
     * Pret, sub forma 1000 sau 1000.23
     * @var double
     *
     */
    public $pret;

    /**
     * In cazul in care aveti o promotie, completati si pretul nou.
     * $pret_nou trebuie sa fie mai mic decat $pret
     * @var double
     *
     */
    public $pret_nou;

    /**
     * Data pana la care este valabila promotia, in format timestamp
     * @var int
     *
     */
    public $pana_cand;

    /**
     * Unitatea de masuna, poate fi luna, an, km, buc
     * @var string
     *
     */
    public $um;

    /**
     * Moneda, valori posibile
     * 1 = EUR
     * 2 = USD
     * 3 = RON
     * @var int
     *
     */
    public $moneda;

    /**
     * ID judet, trebuie setat conform notatiei online.anuntul.ro, pentru mapare folosite $client->getJudete();
     * Daca judetul este nu Bucuresti ( ID judet = 10), este necesar completarea campului de localitate $anunt->localitate_id
     *      pentru mapare se va folosi $anunt->localitate_id = $client->getLocalitati($idJudet,$numeLocalitate);
     * @var int
     *
     */
    public $idjud = '';


    /**
     * Localitatea oblogatoriu de completat doar daca se alege judet altul decat Bucuresti
     * @var int
     *
     */
    public $localitate_id;


    /**
     * Strada
     * @var string
     *
     */
    public $strada;

    /**
     * Numarul strazii
     * @var string
     *
     */
    public $nr_strada;

    /**
     * Latitudine, ex: 44.4095832
     * @var double
     *
     */
    public $lat;

    /**
     * Longitutidne, ex: 26.139221200000065
     * @var double
     *
     */
    public $lng;

    /**
     * Adresa de e-mail, obligatorie in lista unui telefon
     * @obligatoriu email sau telefon
     * @var string
     *
     */
    public $email;

    /**
     * In cazul in care nu doriti ca adresa de e-mail sa fie afisata, setati 1
     * @var int
     *
     */
    public $not_display_email;

    /**
     * Adresa website-ului
     * @var string
     *
     */
    public $site;

    /**
     * Numarul de telefon, obligatoriu in lipsa unei adresa de e-mail
     * @obligatoriu telefon sau email
     * @var string
     *
     */
    public $telefon1;

    /**
     * Numarul de telefon
     * @var string
     *
     */
    public $telefon2;

    /**
     * Adresa de youtube
     * @var string
     *
     */
    public $youtube_url;

    /**
     * Vector de imagini, sunt permise maxim 8 imagini, ex: $anunt->imagini = array('http://sitemeu.ro/imaginea1.jpg',''http://sitemeu.ro/imaginea2.jpg');
     * @var array
     *
     */
    public $imagini;

    /**
     * Link catre pagina de detalii a produsului pe site-ul dumneavoastra
     * @var string
     *
     */
    public $link_produs;


    /**
     * Vector de campuri aditionale
     * @obligatoriu
     * @var string
     *
     */
    public $campuri_aditionale;

}

?>

Mesaje returnate

Cod returnat (faultcode)	Descriere (faultstring)
0	Operatiune reusita
1	Nu esti autentificat
2	Anuntul nu a putut fi validat
3	Imaginiile nu au putut fi adaugate.
4	Anuntul a fost regasit in baza de date, republicati-l.
5	Nu ai dreptul la aceasta operatie.

Feed XML sau Web Service