> ## Documentation Index
> Fetch the complete documentation index at: https://api.housera.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducere

> Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din aplicația ta.

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

<CardGroup cols={3}>
  <Card title="Agenții" icon="building">
    Îț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.
  </Card>

  <Card title="Proprietari" icon="house">
    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.
  </Card>

  <Card title="CRM-uri" icon="plug">
    Sincronizezi anunțurile clienților tăi după id-ul din CRM, asculți webhook-urile și reconciliezi zilnic.
  </Card>
</CardGroup>

## 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

<Steps>
  <Step title="Îți creezi o cheie">
    Din contul tău, la [Setări → API](https://housera.ro/setari/api). Începe cu o cheie de sandbox.
  </Step>

  <Step title="Îți verifici maparea">
    `POST /listings/validate` aplică toate regulile fără să scrie nimic. Repari ce-ți semnalează, până primești `{"valid": true}`.
  </Step>

  <Step title="Publici">
    `POST /listings` (sau `PUT /listings/ref/{ref}`, dacă lucrezi cu id-urile tale). Anunțul intră în moderare, cu starea `pending`.
  </Step>

  <Step title="Adaugi pozele">
    `PUT /listings/{code}/photos`, cu URL-uri publice sau cu fișiere urcate direct.
  </Step>

  <Step title="Afli rezultatul">
    Primești un webhook `listing.published` sau `listing.rejected`. Dacă endpointul tău a fost căzut, recuperezi din `GET /events`.
  </Step>
</Steps>

## Adresele

| Mediu | Adresă de bază |
| - | - |
| Sandbox | `https://staging.housera.ro/api/v1` |
| Producție | `https://housera.ro/api/v1` |

Toate cererile folosesc HTTPS și JSON. Fiecare răspuns are antetul `X-Request-Id`, după care găsești cererea în [jurnalul API](/ro/log).

## Mai departe

<CardGroup cols={2}>
  <Card title="Primul anunț în 5 minute" icon="rocket" href="/ro/quickstart">
    De la cheie la un anunț în moderare, cu exemple în curl, PHP, JavaScript și Python.
  </Card>

  <Card title="Câmpurile unui anunț" icon="list" href="/ro/guides/listing-payload">
    Ce trimiți pentru un apartament, o casă, un teren sau un spațiu comercial.
  </Card>

  <Card title="Moderarea și stările" icon="shield-check" href="/ro/concepts/moderation">
    Ce se întâmplă cu un anunț după ce îl trimiți și cum afli rezultatul.
  </Card>

  <Card title="Pentru CRM-uri" icon="arrows-rotate" href="/ro/crm">
    Fluxul recomandat pentru o sincronizare robustă.
  </Card>

  <Card title="Webhook-uri" icon="bell" href="/ro/webhooks">
    Evenimentele, semnătura și reîncercările.
  </Card>

  <Card title="Erori" icon="triangle-exclamation" href="/ro/errors">
    Formatul erorilor și toate codurile pe care ramifici.
  </Card>
</CardGroup>

<Note>
  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.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.