Documentație API VDI.ro

Trimite agenții și ofertele direct din CRM-ul agenției tale

Agențiile care au deja un CRM propriu nu trebuie să republice nimic manual pe VDI.ro: trimit ofertele și agenții prin două adrese, iar portalul le ține la zi singur. Aceleași adrese sunt folosite de CRM-urile integrate deja, deci nu e o cale paralelă.

Datele se trimit ca JSON. Fiecare ofertă și fiecare agent se recunosc după numărul lor din sistemul tău — idintern — ceea ce înseamnă că același apel repetat actualizează, nu dublează.

key

Cheia de acces

Fiecare agenție are cheia ei, legată de contul de pe VDI.ro. Se cere de la suport@vdi.ro sau din pagina de contact. Cheia merge în adresă, ca parametru, la fiecare apel.

Cele două adrese

Adresă	Ce face
`POST /apioferte`	Ofertele: adaugă, modifică, șterge, listează
`POST /api`	Agenții agenției: adaugă, modifică, șterge

Operațiunea se trece tot în adresă, ca cat: add, mod, del, iar la oferte și list.

POST https://vdi.ro/apioferte?apikey=CHEIA_TA&cat=add
Content-Type: application/json

{
  "idintern": 4187,
  "idagent": 262,
  "titlu": "Apartament 3 camere, Zorilor, bloc nou",
  "tipoferta": 1,
  "tipoperatiune": 2,
  "judetul": "Cluj",
  "localitatea": "Cluj-Napoca",
  "cartierul": "Zorilor",
  "moneda": 1,
  "pretvanzare": 145000,
  "suprafatautila": 68,
  "numarcamere": "3",
  "etajul": "2",
  "etaje": "4"
}

Nu trimite prin www.vdi.ro dacă programul tău nu reia cererea după o mutare permanentă: adresa canonică e vdi.ro, fără www.

Câmpurile unei oferte

Cele obligatorii sunt marcate. Restul se trimit dacă le ai — cu cât mai multe, cu atât anunțul apare în mai multe filtre.

Câmp	Valori	Ce e
`idintern` obligatoriu	număr	Numărul ofertei în CRM-ul tău. Obligatoriu — după el se recunoaște oferta la modificări.
`titlu` obligatoriu	text, minimum 10 caractere	Titlul anunțului. Sub 10 caractere e respins.
`tipoferta` obligatoriu	1–8	1 apartament, 2 casă, 3 spațiu comercial, 4 teren, 5 spațiu industrial, 6 birou, 7 garsonieră, 8 hotel
`tipoperatiune` obligatoriu	1 sau 2	1 închiriere, 2 vânzare
`judetul` obligatoriu	text	Numele județului, scris normal: „Cluj", „Argeș".
`localitatea` obligatoriu	text	Trebuie să existe în județul trimis, altfel oferta e respinsă.
`moneda` obligatoriu	1 sau 2	1 EUR, 2 RON
`cartierul`	text	Cartierul sau zona. Dacă nu se potrivește cu nimic cunoscut, oferta intră fără el.
`idagent`	număr	Numărul agentului în CRM-ul tău. Fără el, anunțul apare pe datele agenției.
`pretvanzare`	număr	Prețul de vânzare.
`pretinchiriere`	număr	Prețul lunar, la închiriere.
`suprafatautila`	număr	Suprafața utilă, în metri pătrați. Trebuie să fie numerică.
`suprafataconstruita`	număr	Suprafața construită. Trebuie să fie numerică.
`suprafatateren`	număr	Suprafața terenului. Trebuie să fie numerică.
`numarcamere`	text sau număr	Numărul de camere.
`numarbai`	text sau număr	Numărul de băi.
`etajul`	text	Etajul: „2", „parter", „demisol", „mansarda".
`etaje`	text	Câte etaje are clădirea.
`negociabil`	0 sau 1	Dacă prețul e negociabil.
`optiuni`	text	Dotările, separate prin virgulă. O dotare necunoscută respinge oferta.
`poze`	text	Adresele fotografiilor, separate prin virgulă.

Agenții agenției

Trimiși înaintea ofertelor: o ofertă cu idagent care nu există încă pe VDI.ro este respinsă. Fiecare agent primește contul lui, iar anunțurile apar cu numele și telefonul lui.

POST https://vdi.ro/api?apikey=CHEIA_TA&cat=add
Content-Type: application/json

{
  "idintern": 262,
  "firstname": "Andrei",
  "lastname": "Popescu",
  "email": "andrei@agentia.ro",
  "phone": "0722 123 456",
  "photo": "https://agentia.ro/agenti/andrei.jpg"
}

Emailul e obligatoriu și trebuie să fie al agentului: pe el se face contul. Un email deja folosit de alt agent este respins, ca să nu ajungă doi oameni în același cont.

Ce răspunde

Răspunsul e mereu JSON, cu o singură cheie. Numele ei este eroare și la reușită, și la respingere — se citește textul, nu cheia.

{"eroare":"Proprietatea a fost adaugata. ID: VDI126.1262725 | Link: https://vdi.ro/..."}
{"eroare":"Localitatea este invalida"}
{"eroare":"Cheie invalida"}

Respingerile cele mai dese

`Cheie invalida`	Cheia e greșită, sau contul agenției nu are publicarea prin API pornită.
`Localitatea este invalida`	Localitatea nu există în județul trimis. Verifică scrierea, cu diacritice.
`Judetul este invalid`	Numele județului nu e recunoscut.
`Titlul ofertei trebuie sa aiba minim 10 caractere`	Titlul e prea scurt.
`Suprafata construita trebuie sa fie numerica`	S-a trimis text acolo unde se aștepta un număr — de pildă „120 mp" în loc de 120.
`Agentul cu id intern N nu a fost gasit`	Agentul trebuie trimis întâi, prin adresa de agenți.
`JSON invalid`	Corpul cererii n-a ajuns, sau nu e JSON valid.
`Abonamentul a expirat`	Contul agenției nu mai e activ pe portal.

Despre diacritice

Trimite textul ca UTF-8 curat: Slătioarele, nu Slătioarele. Portalul desface literele scrise ca entități HTML, dar e mai bine să nu ajungă așa — cu ele, adresa anunțului ieșea cu cifre în mijlocul cuvintelor.

Nu merge ceva, sau ai nevoie de un câmp care nu e aici? Scrie la suport@vdi.ro — fiecare apel respins rămâne în jurnalul agenției tale și îl putem citi împreună.