Documentație API TET

Integrează sistemul tău CRM imobiliar cu TET

TET pune la dispoziția agențiilor imobiliare un set de endpoint-uri API REST pentru a sincroniza automat portofoliul de proprietăți, agenți și agenții direct din software-ul tău intern.

Documentația acoperă autentificarea, formatele de date acceptate (JSON) și exemple practice pentru fiecare operațiune disponibilă.

key

Cum obții cheia API

Cheia API e disponibilă pentru agențiile cu cont activ pe TET. Contactează-ne la contact@vdi.ro sau prin pagina Contact pentru a primi acces și documentație detaliată.

Endpoint-uri disponibile

Autentificare

Toate cererile către API necesită un token de autentificare în header.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Adăugare agenți

POST /api/legacy/agents

Adaugă un cont nou de agent în sistem. Câmpuri obligatorii: id_intern, nume, prenume, email, telefon.

Exemplu JSON

{
  "id_intern": 12345,
  "nume": "Popescu",
  "prenume": "Ion",
  "telefon": "0712345678",
  "telefon2": "",
  "email": "ion.popescu@agentie.ro",
  "functie": "Agent imobiliar",
  "poza": "https://siteulagentiei.ro/agenti/ion.jpg",
  "localitate": "București",
  "facebook": "https://facebook.com/ion.popescu",
  "linkedin": "",
  "descriere": "10 ani experiență în Imobiliare Rezidențiale"
}

Modificare agenți

PUT /api/legacy/agents/{id_intern}

Actualizează datele unui agent existent. Identificarea se face prin id_intern (ID-ul agentului în CRM-ul tău).

Ștergere agenți

DELETE /api/legacy/agents/{id_intern}

Marchează un agent ca inactiv. Anunțurile asociate rămân în sistem dar nu mai apar pe pagina agentului.

Adăugare/actualizare anunțuri

POST /api/legacy/properties

Sincronizează un anunț (proprietate). Suportă apartament, casă, teren, spațiu comercial, birou, industrial, hotel, garsonieră.

Câmpuri principale: id_intern, tip, tranzactie, pret, moneda, judet, oras, cartier, camere, suprafata_utila, etaj, poze[], descriere, id_agent.

Ștergere anunțuri

DELETE /api/legacy/properties/{id_intern}

Marchează anunțul ca vândut/inactiv. Util la sincronizare automată din CRM intern.

Format răspunsuri

Răspunsurile API sunt JSON cu structură consistentă:

// SUCCESS
{
  "success": true,
  "data": { ... },
  "message": "Operațiune efectuată cu succes"
}

// EROARE
{
  "success": false,
  "error": "DESCRIPTION_OF_ERROR",
  "message": "Mesaj user-friendly"
}

Limite de utilizare

Rate limit: 60 cereri / minut per API key
Bulk uploads: max 100 anunțuri / cerere
Imagini: max 30 poze / anunț, format JPG/PNG/WebP, max 5MB / imagine

Ai nevoie de acces API?

Contactează echipa noastră pentru a primi cheia API și documentația tehnică completă.

Solicită acces API