Anunțuri
Prezentare anunțuri
Tipuri de proprietăți, statusuri și ciclul de viață al anunțurilor
Anunțurile sunt resursa principală a API-ului. Prin ele publici proprietăți pe Rentix: apartamente, case, birouri, parcări.
Ce poți face
| Acțiune | Descriere |
|---|---|
| Creează anunț | Adaugă o proprietate nouă |
| Actualizează anunț | Modifică prețul, descrierea, caracteristicile |
| Publică | Fă anunțul vizibil pe site |
| Ascunde | Ascunde temporar de pe site |
| Operații în masă | Procesează până la 100 anunțuri per cerere |
Tipuri de anunțuri
Fiecare anunț are un tip de tranzacție și un tip de proprietate:
Tip tranzacție
| Valoare | Descriere |
|---|---|
rent | Închiriere (zilnic, lunar) |
sale | Vânzare |
Tipuri de proprietăți
| Tip | Subtipuri | Exemple |
|---|---|---|
residential | apartment, house, room, residential-land, other | Apartamente, case, camere |
commercial | office, trade, warehouse, production, business, commercial-land, other | Birouri, magazine, depozite |
parking | underground-parking, open-parking, garage, covered-parking, other | Garaje, locuri de parcare |
Statusuri anunțuri
Statusul determină dacă anunțul este vizibil pe site și ce poți face cu el.
| Status | Descriere | Vizibilitate | Ce să faci |
|---|---|---|---|
draft | Ciornă | Doar tu | Adaugă fotografii, setează active |
pending_active | În procesare | Doar tu | Așteaptă finalizarea |
active | Publicat | Toți | Anunțul este pe site |
hidden | Ascuns de tine | Doar tu | Setează active pentru a reveni |
expired | Expirat | Doar tu | Setează active pentru prelungire |
completed | Tranzacție finalizată | Toți | Poți reveni la active sau hidden |
publish_failed | Eroare | Doar tu | Corectează și încearcă din nou |
blocked | Blocat | Doar tu | Contactează suportul |
Validarea completă a câmpurilor obligatorii se efectuează doar pentru statusurile publice (
active, expired, completed). Ciornele și anunțurile ascunse pot fi salvate cu date incomplete.Ciclul de viață
┌─────────────┐
│ draft │ ← Creare
└──────┬──────┘
│ announcementStatus: "active"
▼
┌─────────────┐
│pending_active│ ← Procesare (fotografii, traducere)
└──────┬──────┘
┌────────┴────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ active │ │publish_failed│
└──────┬──────┘ └─────────────┘
┌──────┬──────┼──────┐
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ hidden │ │completed│ │expired │ ← După 30 zile
└────────┘ └────────┘ └────────┘
Tranziții tipice
| Din | În | Cum |
|---|---|---|
draft | pending_active | Setează announcementStatus: "active" + minim 3 fotografii |
pending_active | active | Automat după procesare |
active | hidden | Setează announcementStatus: "hidden" |
hidden | active | Setează announcementStatus: "active" |
active | expired | Automat după 30 zile |
expired | pending_active | Setează announcementStatus: "active" |
active | completed | Setează announcementStatus: "completed" |
completed | active | Setează announcementStatus: "active" |
Durată de viață
Anunțul este activ 30 zile de la publicare. După aceea:
- Statusul se schimbă automat în
expired - Anunțul dispare de pe site
- Datele sunt păstrate — poți prelungi
Pentru a prelungi anunțul, setează announcementStatus: "active" — sistemul îl va procesa din nou și îl va publica pentru următoarele 30 zile.
Limitări
| Parametru | Valoare |
|---|---|
| Fotografii pentru publicare | 3–20 bucăți |
| Lungime descriere | 40–2000 caractere |
| Operații bulk | Până la 100 anunțuri per cerere |
Endpoint-uri API
| Metodă | Cale | Descriere |
|---|---|---|
PUT | /listings | Creează sau actualizează |
POST | /listings/validate | Verifică fără salvare |
POST | /listings/bulk | Operații în masă |
GET | /listings | Lista anunțuri |
GET | /listings/:id | Obține după ID |
GET | /listings/external/:externalId | Obține după external ID |
POST | /listings/:id/link | Leagă external ID |
DELETE | /listings/:id/link | Dezleagă external ID |
Pașii următori
- Creează anunț — exemplu complet cu descrierea tuturor câmpurilor
- Încarcă fotografii — modalități de încărcare fișiere media
- Operații bulk — sincronizarea mai multor anunțuri