Salt la conținutul principal
Sandboxul e o copie separată a platformei, pe care îți construiești și îți testezi integrarea fără să atingi anunțurile reale. Rulează același cod ca producția, deci regulile, codurile de eroare, moderarea și webhook-urile se comportă la fel.

Chei diferite pentru fiecare mediu

Conturile, cheile, anunțurile și webhook-urile sunt separate între cele două medii. O cheie hsr_test_ nu funcționează în producție și invers. Când treci în producție, creezi o cheie nouă din contul tău de pe housera.ro și îți reconfigurezi webhook-urile acolo.
Ține adresa de bază și cheia în configurație (variabile de mediu), nu în cod. Trecerea în producție înseamnă atunci doar două valori schimbate.

Ce poți testa

  • Maparea câmpurilor: trimite anunțuri de toate tipurile pe care le ai în sistem la POST /listings/validate și repară ce primești în errors[] și warnings[].
  • Fluxul complet: creare, poze, editare, pauză, reactivare, vândut, ștergere.
  • Webhook-urile: butonul „Trimite un test” din Setări → API trimite un eveniment webhook.test semnat, ca să-ți verifici endpointul și semnătura.
  • Recuperarea: oprește-ți endpointul o vreme, apoi recuperează evenimentele pierdute din GET /events.
  • Conflictele: editează un anunț din portalul de sandbox, apoi trimite o editare prin API cu If-Match vechi și verifică faptul că primești 412.

Date de test

  • Folosește date inventate: adrese și coordonate reale de oraș sunt în regulă, dar fără nume, telefoane sau emailuri ale unor persoane reale.
  • Pentru poze, folosește imagini pe care ai dreptul să le folosești, servite de pe un URL public HTTPS sau urcate direct.
  • Emailurile pe care sandboxul le-ar trimite (confirmări, notificări de moderare) nu ajung la destinatari reali.

Moderarea în sandbox

Anunțurile noi intră în moderare și aici, cu starea pending, exact ca în producție. Rămân în această stare până când sunt aprobate sau respinse. Integrarea ta trebuie să trateze un anunț pending ca pe o stare normală, care poate dura.
Datele din sandbox nu sunt garantate pe termen lung: mediul poate fi golit sau reconstruit. Nu păstra acolo nimic de care ai nevoie mai târziu.