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

# Sandbox

> Mediul de test: aceleași reguli ca producția, fără efecte asupra anunțurilor reale.

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.

| | Sandbox | Producție |
| - | - | - |
| Adresa API | `https://staging.housera.ro/api/v1` | `https://housera.ro/api/v1` |
| Unde creezi cheile | `https://staging.housera.ro/setari/api` | `https://housera.ro/setari/api` |
| Prefixul cheii | `hsr_test_` | `hsr_live_` |
| Anunțurile | de test, nu le vede publicul | reale, apar în căutare după aprobare |
| Emailurile | nu pleacă la destinatari reali | pleacă normal |

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

<Tip>
  Ț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.
</Tip>

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

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


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