Salt la conținutul principal
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:
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; î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

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.