For a better experience please change your browser to CHROME, FIREFOX, OPERA or Internet Explorer.

Documentatie API

Accesul la API se acorda la cerere tuturor agentiilor ce detin un cont de promovare activ pe platforma Imobiliar.ro

Pentru activarea serviciului va rugam sa ne contactati la office@imobiliar.ro

Accesul se realizeaza prin intermediul unei chei secrete numita APIKEY.

API-ul ofera posibilitatea de a publica pe Imobiliar.ro anunturi si de a le gestiona in cel mai scurt timp.

API-ul va pune la dispozitie urmatoarele operatiuni:

interogare informatii cont

adaugare anunt

stergere anunt

afisare informatii anunt (export)

afisare lista anunturi

promovare anunt

reactualizare anunt (TOP)

editare anunt

Accesul la API se face prin intermediul requesturilor POST JSON catre linkul „https://imobiliar.ro/api

Se accepta doar requesturi de tip POST in format JSON, iar raspunsurile oferite sunt de asemenea doar in format JSON.

Pentru validarea requesturilor, orice raspuns va primi ca raspuns un mesaj „rezultat” ce contine valorile „succes” sau „eroare„.

Mai jos gasiti informatii pentru fiecare operatiune in parte. Pentru informatii suplimentare va stam la dispozitie.

Interogarea informatii despre cont va pune la dispozitie:

-pachetul de promovare al contului (pachet)

-data de expirare a pachetului de promovare (expirare_cont)

-numarul de credite standard. 1 credit = postare 1 anunt. (credite_standard)

-numarul de credite de promovare. 1 credit = promovare 1 anunt (credite_promovare)

-numarul de credite de reactualizare TOP. 1 credit = reactualizare 1 anunt (credite_top)

-variabila rezultat cu valoarea succes in cazul in care interogarea a fost cu succes si eroare in caz contrat. (rezultat)

Requestul pentru afisarea informatii despre cont se face catre linkul API: https://imobiliar.ro/api si trebuie sa contina 2 parametri:

apikey” si  „infocont” (cu valoare 1)

Exemplu interogare informatii cont

Pentru adaugarea unui anunt se va face un request catre https://imobiliar.ro/api/ ce contine minim si obligatoriu urmatorii parametri:

apikey, titlu, categorie, tip, judet, nume, telefon, descriere, pret

Parametrii de mai sus, sunt informatiile minime pe care un anunt trebuie sa le cuprinda pentru a putea fi creat.

Rezultatul va contine o variabila rezultat de tip succes/eroare insotit de un mesaj („Anuntul a fost adaugat” in caz de succes, si un mesaj corespunzator erorii in caz de eroare ). In caz de succes va fi returnat si ID-ul anuntului nou creat.

LISTA PARAMETRI ADMISI

apikey – obligatoriu

titlu – maxim 100 caractere – obligatoriu

categorie – valori posibile (apartament, birou, casa, garsoniera, teren, comercial, industrial) – obligatoriu

tip – valori posibile (vanzari, inchirieri) – obligatoriu

judet – valori posibile (numele judetului, litere mici. Ex: bucuresti, brasov) – obligatoriu

nume – nume/prenume sau nume agentie – obligatoriu

telefon – numar de contact  – obligatoriu

descriere – descriere anunt, maxim 10000 caractere – obligatoriu

pret – pretul in euro. Se accepta doar cifre, fara punct sau virgula.

PARAMETRI OPTIONALI

adresa – nume strada si localitate, sau doar localitate (ex: Str. Rahovei, Ploiesti sau „Ploiesti”)

map_lat – latitudine harta (ex: 45.4097148)

map_long – longitudine harta (ex: 25.5342236)

id_intern – numar de identificare intern al agentiei

an_constructie – anul constructie (ex: 2015)

confort – valori 1, 2 sau 3

etaj – valori de la 1 la 11+

locuinta_mobilata – valori (Nemobilat, Partial, Complet, Lux)

numar_bai (0,1,2,3,4+)

numar_camere (1,2,3,4+)

suprafata_utila (suprafata in metri patrati)

suprafata_construita (suprafata in metri patrati)

vandut_de (Persoana fizica / Agentie)

clasificare_teren (intravilan/etravilan)

front_stradal (in metri)

suprafata_teren (in metri patrati)

url_imagine1 (linkul unei imagini format JPG/PNG. Imaginea va fi copiata pe serverul imobiliar.ro automat)

url_imagine2

url_imagine 3

…..

url_imagine10 (puteti adauga un maxim de 10 imagini prin API)

Exemplu Adaugare Anunt

Puteti modifica un anunt, atat unul care a fost aprobat cat si unul care inca are statusul „Pending”, in asteptarea aprobarii.

Requestul se face la fel ca la adaugarea anuntului, singura modificare este ca daca parametrul id_anunt este prezent in request, inseamna ca se doreste editarea anuntului. Astfel se face diferentierea intre crearea unui anunt nou si editarea unuia deja existent. In cazul editarii trebuie specificat ID-ul anuntului in cauza prin intermediul parametrului id_anunt.

Exemplu Editare Anunt

Pentru a marca un anunt ca promovat sunt necesari 3 parametri:

apikey, id_anunt, promovare (cu valoarea 1)

In cazul in care contul nu mai dispune de credite de promovare, va fi afisat un mesaj de eroare. Puteti verifica numarul de credite de promovare disponibile prin interogarea informatiilor cont.

Exemplu Promovare Anunt

Pentru a reactualiza un anunt (anunt TOP) sunt necesari 3 parametri:

apikey, id_anunt, reactualizare (cu valoarea 1)

In cazul in care contul nu mai dispune de credite de reactualizare (top), va fi afisat un mesaj de eroare. Puteti verifica numarul de credite TOP disponibile prin interogarea informatiilor cont.

Exemplu Reactualizare Anunt

Pentru a citi/afisa informatiile unui anunt sunt necesari 3 parametri:

apikey, id_anunt, afisare (cu valoarea 1)

Vor fi afisate toate informatiile pe care anuntul le contine.

Puteti face un request pentru afisare doar pentru anunturile din contul dvs. In caz contrar va fi returnat un rezultat de eroare insotit de mesajul „Contul dvs. nu este administratorul acestui anunt.”

Exemplu Afisare Informatii Anunt

Pentru afisarea unei liste cu anunturile din cont sunt necesari 2 parametri:

apikey, listare (cu valoarea 1)

Va fi afisata o lista ce contine fiecare anunt cu urmatoarele informatii (id_anunt, id_intern, anunt_promovat)

Exemplu Afisare Lista Anunturi

Pentru a sterge un anunt sunt necesari 3 parametri:

apikey, id_anunt, stergere (cu valoarea 1)

Va fi returnat un rezultat succes in cazul in care anuntul a fost sters, si un rezultat de eroare in caz contrar (un mesaj de eroare va fi afisat in cazul in care se incearca stergerea unui anunt cu un id care nu apartine contului).

Exemplu Stergere Anunt

Top