Salt la conținutul principal
API-ul Housera îți permite să publici, să editezi și să retragi anunțuri imobiliare direct din sistemul tău, fără să treci prin formularul de pe site. Primești înapoi starea fiecărui anunț, rezultatul moderării și orice schimbare făcută între timp în portal.

​
Pentru cine e

Agenții

Îți publici tot stocul dintr-un singur loc. Anunțurile apar sub numele agenției, ca atunci când le adaugă un agent din cont.

Proprietari

Ai câteva proprietăți într-o foaie de calcul sau într-o aplicație proprie? Le publici cu o cheie din contul tău.

CRM-uri

Sincronizezi anunțurile clienților tăi după id-ul din CRM, asculți webhook-urile și reconciliezi zilnic.

​
Aceleași reguli ca formularul Housera

Nu există reguli speciale pentru API. Un anunț trimis prin API trece prin exact aceleași verificări ca unul completat în formularul de pe housera.ro:
  • ce e obligatoriu pentru fiecare tip de proprietate (un apartament are etaj, o casă are teren, un teren are suprafață);
  • ce valori sunt permise pentru fiecare câmp;
  • verificările între câmpuri (etajul nu depășește numărul de etaje, dormitoarele nu sunt mai multe decât camerele);
  • moderarea: orice anunț nou e verificat de un om înainte să apară în căutare.
Ce poți publica din cont poți publica și prin API. Ce formularul refuză, refuză și API-ul, imediat și cu un cod de eroare stabil.

​
Cum arată fluxul

1

Îți creezi o cheie

Din contul tău, la Setări → API. Începe cu o cheie de sandbox.
2

Îți verifici maparea

POST /listings/validate aplică toate regulile fără să scrie nimic. Repari ce-ți semnalează, până primești {"valid": true}.
3

Publici

POST /listings (sau PUT /listings/ref/{ref}, dacă lucrezi cu id-urile tale). Anunțul intră în moderare, cu starea pending.
4

Adaugi pozele

PUT /listings/{code}/photos, cu URL-uri publice sau cu fișiere urcate direct.
5

Afli rezultatul

Primești un webhook listing.published sau listing.rejected. Dacă endpointul tău a fost căzut, recuperezi din GET /events.

​
Adresele

Toate cererile folosesc HTTPS și JSON. Fiecare răspuns are antetul X-Request-Id, după care găsești cererea în jurnalul API.

​
Mai departe

Primul anunț în 5 minute

De la cheie la un anunț în moderare, cu exemple în curl, PHP, JavaScript și Python.

Câmpurile unui anunț

Ce trimiți pentru un apartament, o casă, un teren sau un spațiu comercial.

Moderarea și stările

Ce se întâmplă cu un anunț după ce îl trimiți și cum afli rezultatul.

Pentru CRM-uri

Fluxul recomandat pentru o sincronizare robustă.

Webhook-uri

Evenimentele, semnătura și reîncercările.

Erori

Formatul erorilor și toate codurile pe care ramifici.
Pe lângă anunțurile tale, cu o cheie cu dreptul listings:read poți citi și catalogul public de anunțuri active: GET /listings și GET /listings/{code}. Detaliile sunt în referința API.