Online Anuntul
Platforma proprie`
Platforme
Obtinere acces autorizat
 
Aplicatie transfer Anuntul Online
 
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
 
 
anunt.class.php doar informativ, nu este necesara includerea clasei in client.php
 
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