Documentație feed-uri

Câmpuri standard

Indiferent de format (XML/CSV/JSON), iMove mapează coloanele tale la următoarea structură canonică:

Pentru valori enum: transactionType = SALE/RENT (acceptăm și „vanzare"/„inchiriere"), propertyType ∈ {APARTMENT, STUDIO, HOUSE, LAND, COMMERCIAL, OFFICE} (acceptăm și „apartament"/„casa"/„teren").

Reguli pentru imagini

• URL-uri publice HTTPS, accesibile fără autentificare.
• Format: JPG, PNG, WebP. Recomandat: minimum 1200×800 px.
• Maxim 40 imagini per anunț.
• În CSV, separă URL-urile cu ; sau ,. În XML, folosește tag-uri <image>…</image> repetate.
• La fiecare sync, dacă lista de imagini din feed se modifică, imaginile vechi sunt înlocuite.

Feed XML

Structură recomandată: container repetat <listing> cu câmpurile de mai sus ca tag-uri imediate.

<?xml version="1.0" encoding="UTF-8"?>
<listings>
 <listing>
 <externalId>AG-12345</externalId>
 <title>Apartament 2 camere, Pipera</title>
 <description>...</description>
 <price>129500</price>
 <currency>EUR</currency>
 <transactionType>SALE</transactionType>
 <propertyType>APARTMENT</propertyType>
 <city>bucuresti</city>
 <rooms>2</rooms>
 <usableArea>62</usableArea>
 <images>
 <image>https://cdn.agentia.ro/12345/01.jpg</image>
 <image>https://cdn.agentia.ro/12345/02.jpg</image>
 </images>
 </listing>
</listings>

Feed CSV

Acceptăm separator , ; | sau tab (auto-detectat). Prima linie = header. Encoding UTF-8 (BOM-ul se ignoră automat).

externalId,title,price,currency,transactionType,propertyType,city,rooms,usableArea,imageUrls
AG-12345,"Apartament 2 camere",129500,EUR,SALE,APARTMENT,bucuresti,2,62,"https://cdn.agentia.ro/12345/01.jpg;https://cdn.agentia.ro/12345/02.jpg"
AG-12346,"Casă 4 camere",325000,EUR,SALE,HOUSE,cluj-napoca,4,140,"https://cdn.agentia.ro/12346/01.jpg"

Feed JSON

Răspunde cu un obiect care conține un array listings (sau properties sau items).

API agenție (planuri Pro+)

Generează cheie din Agenție → API. Cheia apare o singură dată — salveaz-o.

Autentificare

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

# Listează anunțurile agenției
GET /api/agency-api/properties?page=1&pageSize=50

# Bulk upsert (creează SAU actualizează după externalId)
POST /api/agency-api/properties
Content-Type: application/json
{ "properties": [ {"externalId":"AG-1","title":"...","price":120000, ...} ] }

# Anunț unic după externalId
GET /api/agency-api/properties/AG-12345
PUT /api/agency-api/properties/AG-12345
DELETE /api/agency-api/properties/AG-12345

# Trigger sync feeds
POST /api/agency-api/sync
{ "feedId": "..." } # opțional, dacă lipsește se sync toate feed-urile ACTIVE

Rate limit per cheie: configurat conform planului tău (60–600 req/min). Toate request-urile sunt înregistrate pentru audit.