Documentație API Ofera.ro

Accesul la API este disponibil doar companiilor partenere care conțin un api key eliberat în bază de contract

Pentru a deveni partener, te rugăm să ne contactezi la contact@ofera.ro sau pe formularul de contact.

Documentația tehnică a versiunilor de API disponibile o aveți mai jos, implementarea ei urmărește standardul OAuth2.

Exemplu adăugare anunț

Request:
POST https://admin.ofera.ro/api/v1/create-product
Headers:
Content-Type: application/json
Accept: application/json
Authorization: Bearer __access_token__
POST data (json format) Response:
Notă:
  • Ordinea imaginilor se dă prin parametrul order din fiecare image object în array-ul images. Imaginea marcată cu poziția 0 va fi considerată principală.
    {
        "title": "Apartament 4 camere Mihai Viteazul",
        "description": "Lorem ipsum dolor sit amet, consectetur 
            adipiscing elit, sed do eiusmod tempor incididunt ut
            labore et dolore magna aliqua. Ut enim ad minim veniam,
            quis nostrud exercitation ullamco laboris nisi ut 
            aliquip ex ea commodo consequat. Duis aute irure dolor
            in reprehenderit in voluptate velit esse cillum dolore
            eu fugiat nulla pariatur. Excepteur sint occaecat 
            cupidatat non proident, sunt in culpa qui officia 
            deserunt mollit anim id est laborum.",
        "category_id": 96,
        "images": [{
            "url": "https://ap-4-cam-m-id-19773.jpg",
            "order": 0
        },
        {
            "url": "https://ap-4-cam-m-id-19774.jpg",
            "order": 1
        }],
        "region_id": 4,
        "city_id": 143557,
        "coordinates": {
            "latitude": 45.67307,
            "longitude": 25.31116		
        },
        "advertiser_type": "business",
        "params": {
            "price": {
                "0": "price",
                "1": 60000,
                "currency": "EUR"
            },
            "m": 41,
            "net_area": 39,
            "rooms_num": "4",
            "construction_year": 2009,
            "floor_no": "fl_9",
            "divisioning_type": "detached"
        },
        "agent": {
            "id": 1346,
            "name": "Popescu Ion",
            "email": "popescu.ion@example.com",
            "phone": "0733555666",
            "photo": "https://mysite.ro/agent-image.jpg"
        },
        "external_id": 293155,
        "promoted": 1
    }
    
    {
        "code": "SUCCESS",
        "message": "Adaugat cu succes. Id Ofera.ro: 52",
        "id": 52,
        "status": 200
    }
    

Exemplu adăugare anunț

Câmpurile din params sunt din categoria de adăugare, în acest exemplu imobiliare - apartamente și garsoniere de vânzare - 4+ camere.

Request

POST https://admin.ofera.ro/api/v2/create-product
Headers:
Content-Type: application/json
Accept: application/json
Authorization: Bearer __access_token__

Post data:
{
    "title": "Apartament 4 camere Mihai Viteazul",
    "description": "Lorem ipsum dolor sit amet, consectetur 
        adipiscing elit, sed do eiusmod tempor incididunt ut
        labore et dolore magna aliqua. Ut enim ad minim veniam,
        quis nostrud exercitation ullamco laboris nisi ut 
        aliquip ex ea commodo consequat. Duis aute irure dolor
        in reprehenderit in voluptate velit esse cillum dolore
        eu fugiat nulla pariatur. Excepteur sint occaecat 
        cupidatat non proident, sunt in culpa qui officia 
        deserunt mollit anim id est laborum.",
    "category_id": 96,
    "images"[{
        "url": "https://ap-4-cam-m-id-19773.jpg",
        "order": 0
    },
    {
        "url": "https://ap-4-cam-m-id-19774.jpg",
        "order": 1
    }],
    "city_id": 143557,
    "params"{
        "price": 60000,
        "latitude": 45.67307,
        "longitude": 25.31116
        "region_id": 4,
        "c_suprafata_utila": 41,
        "c_an_constructie": 2009,
        "c_etaj": "9",
        "c_compartimentare": "2"
    },
    "contact"{
        "tip": "business",
        "name": "Popescu Ion",
        "email": "popescu.ion@example.com",
        "phone": "0733555666",
        "photo": "https://mysite.ro/agent-image.jpg"
    },
    "external_id": "293155-alfa",
    "promoted": 1
}

Response

{
    "code": "SUCCESS",
    "message": "Adaugat cu succes. Id OFERA.ro: 52",
    "data"{
        "id": 52,
        "log_track_id": 8254266,
        "valabilitate": "23.09.2019"
    },
    "status": 200
}

API 2.1 este special creat pentru partenerii noștri

Dacă ești magazin online sau dacă ai anunțuri din mai multe surse și nu te ocupi singur de vânzarea acestora, poți aplica pentru un cont de parteneriat. Acest api este pentru tine!

Exemplu adăugare anunț

Câmpurile din params sunt din categoria de adăugare, în acest exemplu imobiliare - apartamente și garsoniere de vânzare - 4+ camere.

Request

POST https://admin.ofera.ro/api/v2.1/create-product
Headers:
Content-Type: application/json
Accept: application/json
Authorization: Bearer __access_token__

Post data:
{
    "id_furnizor": 486,
    "title": "Apartament 4 camere Mihai Viteazul",
    "description": "Lorem ipsum dolor sit amet, consectetur 
        adipiscing elit, sed do eiusmod tempor incididunt ut
        labore et dolore magna aliqua. Ut enim ad minim veniam,
        quis nostrud exercitation ullamco laboris nisi ut 
        aliquip ex ea commodo consequat. Duis aute irure dolor
        in reprehenderit in voluptate velit esse cillum dolore
        eu fugiat nulla pariatur. Excepteur sint occaecat 
        cupidatat non proident, sunt in culpa qui officia 
        deserunt mollit anim id est laborum.",
    "category_id": 96,
    "images"[{
        "url": "https://ap-4-cam-m-id-19773.jpg",
        "order": 0
    },
    {
        "url": "https://ap-4-cam-m-id-19774.jpg",
        "order": 1
    }],
    "city_id": 143557,
    "params"{
        "price": 60000,
        "latitude": 45.67307,
        "longitude": 25.31116
        "region_id": 4,
        "c_suprafata_utila": 41,
        "c_an_constructie": 2009,
        "c_etaj": "9",
        "c_compartimentare": "2"
    },
    "contact"{
        "tip": "business",
        "name": "Popescu Ion",
        "email": "popescu.ion@example.com",
        "phone": "0733555666",
        "photo": "https://mysite.ro/agent-image.jpg"
    },
    "external_id": "293155-alfa",
    "promoted": 1
}

Response

{
    "code": "SUCCESS",
    "message": "Adaugat cu succes. Id OFERA.ro: 52",
    "data"{
        "id": 52,
        "log_track_id": 8254266,
        "valabilitate": "23.09.2019"
    },
    "status": 200
}
Acest site folosește cookies. Continuare navigării implică acceptarea lor.