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

# Jurnalul API

> Fiecare cerere făcută cu cheile tale, cu ce a trimis și ce a primit, vizibilă în cont.

Fiecare cerere făcută cu o cheie a ta e înregistrată. O găsești în cont, cu corpul trimis și răspunsul primit, așa că poți depana singur o integrare, fără să ne scrii.

## `X-Request-Id`

Orice răspuns al API-ului, reușit sau nu, are antetul `X-Request-Id`:

```http theme={null}
HTTP/1.1 422 Unprocessable Content
Content-Type: application/problem+json
X-Request-Id: 01JAQ9B2C4D6E8F0G2H4J6K8M0
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
```

Id-ul identifică în mod unic cererea. Păstrează-l în logurile tale lângă fiecare apel: cu el găsești cererea în jurnal, iar dacă ne ceri ajutor, e primul lucru de care avem nevoie.

## Unde îl vezi

În cont, la **Setări → API → Jurnal** ([housera.ro/setari/api/jurnal](https://housera.ro/setari/api/jurnal); în sandbox, `https://staging.housera.ro/setari/api/jurnal`).

Pentru fiecare cerere vezi:

* **momentul și durata**;
* **cheia** folosită (după nume);
* **metoda, calea și statusul** răspunsului;
* **anunțurile atinse** de cerere;
* **adresa IP și aplicația** (antetul `User-Agent`) de pe care a venit;
* **`Idempotency-Key`**, dacă l-ai trimis;
* **corpul cererii și al răspunsului**.

Dacă ești owner sau admin al unei agenții, vezi și cererile colegilor tăi din agenție.

Poți filtra după:

* **id-ul cererii sau o bucată din cale** (de exemplu `listings/ref/CRM-10293`);
* **codul unui anunț**, ca să vezi tot ce s-a făcut prin API pe el;
* **rezultat**: reușite, erori ale clientului (`4xx`), erori ale serverului (`5xx`);
* **cheie**.

## Ce se păstrează și cât timp

| Ce | Cât timp |
| - | - |
| Corpurile cererii și ale răspunsului | 30 de zile |
| Restul informațiilor despre cerere | 365 de zile |

Corpul cererii e **redactat** înainte de salvare: secretele, cheile și datele de contact nu se păstrează în clar. Răspunsurile API-ului nu conțin date de contact. Un corp mai mare de 64 KB e păstrat doar parțial.

## Ce nu apare

* **Cererile fără o cheie validă** (cheie lipsă, greșită sau expirată) nu pot fi legate de contul tău, deci nu apar în jurnalul tău. Dacă primești `401`, verifică antetul `Authorization` și data de expirare a cheii.
* **Vocabularul cerut fără cheie** (`GET /schema`) nu se înregistrează.

## Istoricul unui anunț

Schimbările făcute prin API apar și în istoricul anunțului, ca modificări „prin API”, cu numele cheii și id-ul cererii. Așa deosebești o editare venită din sistemul tău de una făcută de un coleg direct pe housera.ro.


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