# Housera API ## Început - [Introducere](https://api.housera.ro/ro/index.md): Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din aplicația ta. - [Primul anunț în 5 minute](https://api.housera.ro/ro/quickstart.md): De la cheia de sandbox la un anunț cu poze, trimis la moderare. - [Autentificare](https://api.housera.ro/ro/authentication.md): Cheile API: cum le creezi, ce drepturi au, cât sunt valabile și cum le revoci. - [Sandbox](https://api.housera.ro/ro/sandbox.md): Mediul de test: aceleași reguli ca producția, fără efecte asupra anunțurilor reale. ## Concepte - [Moderarea și stările anunțului](https://api.housera.ro/ro/concepts/moderation.md): Ce se întâmplă cu un anunț după ce îl trimiți, ce poți schimba prin API și cum afli rezultatul. - [Identificatori](https://api.housera.ro/ro/concepts/identifiers.md): Codul Housera, id-ul tău, cheia de idempotență și reconcilierea. - [Editarea](https://api.housera.ro/ro/concepts/editing.md): JSON Merge Patch, versiunile cu ETag și If-Match, și actualizarea după id-ul tău. ## Ghiduri - [Câmpurile unui anunț](https://api.housera.ro/ro/guides/listing-payload.md): Ce trimiți pentru un apartament, o casă, un teren sau un spațiu comercial. - [Locația](https://api.housera.ro/ro/guides/location.md): Coordonatele, orașul și strada unui anunț, și cum le normalizează Housera. - [Pozele](https://api.housera.ro/ro/guides/photos.md): Pozele unui anunț: din URL-uri publice sau urcate direct, cu ordinea și etichetele lor. - [Pentru CRM-uri](https://api.housera.ro/ro/crm.md): Fluxul recomandat pentru o sincronizare robustă între CRM-ul tău și Housera. - [Webhook-uri](https://api.housera.ro/ro/webhooks.md): Afli pe loc ce se întâmplă cu anunțurile tale: evenimentele, semnătura, reîncercările și recuperarea. ## Referință - [Vocabularul](https://api.housera.ro/ro/vocabulary.md): GET /schema: tipurile, câmpurile, unitățile, dotările și codurile retrase, mereu la zi. - [Erori](https://api.housera.ro/ro/errors.md): Formatul erorilor, codurile stabile pe care ramifici și ce înseamnă fiecare status HTTP. ### Anunțurile tale - [Lista anunțurilor tale](https://api.housera.ro/ro/reference/account-listings-index.md): Anunțurile contului (și ale agenției, dacă ești owner sau admin al ei), în orice stare, ordonate după ultima modificare, cu paginare prin cursor. Cu `fields` primești doar câmpurile cerute, de exemplu `code,external_ref,etag,updated_at` pentru reconciliere. - [Un anunț după id-ul tău](https://api.housera.ro/ro/reference/account-listings-ref.md): Anunțul pe care l-ai creat cu `PUT /listings/ref/{ref}`, găsit după id-ul din sistemul tău. - [Un anunț al tău](https://api.housera.ro/ro/reference/account-listings-show.md): Anunțul, cu starea, moderarea și `etag`-ul pe care îl trimiți înapoi în `If-Match`. - [Publică un anunț](https://api.housera.ro/ro/reference/listings-store.md): Creează anunțul și îl trimite la moderare (`pending`). Aceleași reguli ca formularul Housera. Cu antetul `Idempotency-Key`, o cerere repetată întoarce același anunț. - [Validează un anunț](https://api.housera.ro/ro/reference/listings-validate.md): Verifică un anunț cu exact regulile publicării, fără să scrie nimic. Util înainte de primul anunț real, ca să-ți verifici maparea. - [Creează sau actualizează după id-ul tău](https://api.housera.ro/ro/reference/listings-upsert.md): Drumul recomandat pentru un CRM. Dacă id-ul e nou, anunțul se creează ca la `POST /listings` (201). Dacă e cunoscut, corpul se aplică precum un `PATCH`: câmpurile lipsă își păstrează valoarea. Același corp trimis de două ori nu scrie nimic (`X-Housera-Unchanged: true`). - [Editează un anunț](https://api.housera.ro/ro/reference/listings-update.md): JSON Merge Patch: câmpurile trimise înlocuiesc valorile, `null` golește un câmp, restul rămân. Un anunț încă nepublic se modifică direct (200); unul activ își trimite editarea la moderare (202). Cu `If-Match` vechi primești 412. - [Șterge un anunț](https://api.housera.ro/ro/reference/listings-destroy.md): Șterge o ciornă, un anunț respins, pus pe pauză sau neconfirmat. Un anunț activ sau vândut nu se șterge: îl pui pe pauză sau îl marchezi vândut. - [Marchează vândut sau închiriat](https://api.housera.ro/ro/reference/listings-sold.md): Anunțul iese din căutare și rămâne în istoric. Din `active` sau `paused`. - [Pune pe pauză](https://api.housera.ro/ro/reference/listings-pause.md): Anunțul activ dispare din căutare până îl reactivezi, fără moderare nouă. - [Reactivează](https://api.housera.ro/ro/reference/listings-resume.md): Un anunț pus pe pauză redevine activ, fără moderare nouă. ### Poze - [Setează pozele](https://api.housera.ro/ro/reference/listings-photos.md): Lista completă a pozelor, în ordine (prima e coperta): URL-uri de descărcat sau chei de upload presemnat. O poză care lipsește din listă se șterge. Răspunsul vine imediat (202); pozele se procesează în fundal, iar `media.processing` arată când s-a terminat. - [Pregătește un upload](https://api.housera.ro/ro/reference/uploads-sign.md): Întoarce un URL presemnat la care urci o poză direct (`PUT`, cu exact `Content-Type` și `Content-Length` declarate) și cheia pe care o trimiți apoi la `PUT /listings/{code}/photos`. ### Evenimente - [Evenimentele tale](https://api.housera.ro/ro/reference/events.md): Evenimentele anunțurilor tale din ultimele 35 de zile, de la cel mai vechi, după cursorul `after`. Ce n-a ajuns prin webhook recuperezi de aici. ### Vocabular - [Vocabularul](https://api.housera.ro/ro/reference/schema.md): Tipurile, subtipurile, câmpurile cu tipul și unitatea lor, dotările și codurile retrase. Public, fără cheie; etichetele urmează `locale`, codurile nu se traduc niciodată. ## Mai departe - [Jurnalul API](https://api.housera.ro/ro/log.md): Fiecare cerere făcută cu cheile tale, cu ce a trimis și ce a primit, vizibilă în cont. - [Limite](https://api.housera.ro/ro/limits.md): Limitele de rată, mărimile maxime, câte chei și webhook-uri poți avea și cât se păstrează datele. - [Versiuni și noutăți](https://api.housera.ro/ro/changelog.md): Cum evoluează API-ul fără să-ți strice integrarea, și ce s-a schimbat în fiecare versiune. ## OpenAPI Specs - [openapi](/ro/openapi.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (32 pages)](https://api.housera.ro/_llms/en.txt): Documentation for English. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.