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.

Colecțiile folosite pentru orașe și zone sunt disponibile în Api V2

Colecțiile folosite pentru id-urile parametrilor Ofera.ro

Sunt câțiva parametrii specifici folosiți pentru salvarea anunțurilor prin API astfel încât acestea să fie încadrate în mod corect în baza de date.

Imobiliare

Pentru imobiliare acești parametrii sunt reprezentați de city_id - id-ul localității și region_id - id-ul zonei din localitate.

Obținere informații localitate

Request ID list

Lista de id-uri este cea care va fi folosită să identifice localitatea în city_id.

GET https://admin.ofera.ro/api/v2/cities

Response

[{"id":1026,"nume":"Alba Iulia","judet_id":1},{"id":1035,"nume":"Barabanț","judet_id":1},{"id":1044,"nume":"Micești","judet_id":1},{"id":1053,"nume":"Oarda","judet_id":1},{"id":1062,"nume":"Pîclișa","judet_id":1},{"id":1222,"nume":"Aiud","judet_id":1},{"id":1231,"nume":"Aiudul De Sus","judet_id":1},{"id":1277,"nume":"Ciumbrud","judet_id":1}, ...

Request by ID

Informații detaliate despre fiecare localitate sunt incluse în cadrul cererii specifice după id, pentru situația în care sunt necesare la identificare.

GET https://admin.ofera.ro/api/v2/cities/__CITY_ID__

Response

{
    "id": 1026,
    "nume": "ALBA IULIA",
    "seo_key": "alba-iulia",
    "cod_postal": 0,
    "judet_id": 1,
    ...
}

Request with zones

Pentru situația în care se dorește obtinerea zonelor unei localități specifice acestea se pot încărca per localitate în zones. Id-ul zonei este folosit în params fiind opțional și setat pe region_id.

GET https://admin.ofera.ro/api/v2/cities/__CITY_ID__/tree

Response

{
    "id": 1026,
    "nume": "ALBA IULIA",
    "seo_key": "alba-iulia",
    "cod_postal": 0,
    "judet_id": 1,
    ...
    "zones": [
        {
            "id": 10001,
            "nume": "Ampoi 1"
        },
        {
            "id": 10002,
            "nume": "Ampoi 2"
        },
        {
            "id": 10003,
            "nume": "Ampoi 3"
        },
        {
            "id": 10004,
            "nume": "Barabant"
        },
        ...
    ]
}

Obținere informații Județ

Request ID List

Din cauză că localitățile din România sunt numeroase și încărcarea lor de fiecare dată din baza de date este o operațiune costisitoare ca timp, puteți accesa doar localitățile dintr-un județ.

GET https://admin.ofera.ro/api/v2/counties

Response

[{"id":1,"nume":"Alba"},{"id":2,"nume":"Arad"},{"id":3,"nume":"Arges"},{"id":4,"nume":"Bacau"},{"id":5,"nume":"Bihor"},...

Request by ID

GET https://admin.ofera.ro/api/v2/counties/__COUNTY_ID__

Response

{
    "id": 1,
    "nume": "ALBA",
    "fsj": 1,
    "abr": "AB",
    ...
}

Request with cities

Încarcarea județului cu localitățile din acesta este modul recomandat pentru a vă putea configura eficient id-ul localității în city_id.

GET https://admin.ofera.ro/api/v2/counties/__COUNTY_ID__/tree

Response

{
    "id": 1,
    "nume": "ALBA",
    "fsj": 1,
    "abr": "AB",
    ...
    "cities": [
        {
            "id": 1026,
            "nume": "Alba Iulia"
        },
        {
            "id": 1035,
            "nume": "Barabanț"
        },
        {
            "id": 1044,
            "nume": "Micești"
        },
        {
            "id": 1053,
            "nume": "Oarda"
        },
        {
            "id": 1062,
            "nume": "Pîclișa"
        },
        ...
    ]
}

Obținere listă completă zone

Request ID List

Dacă aveți nevoie să configurați la nivel global zonele din interiorul localităților există posibilitatea de accesare a întregului array de zone. Aceste id-uri se folosesc pentru parametrul opțional region_id.

GET https://admin.ofera.ro/api/v2/zones

Response

[{"id":10217,"nume":"1 Decembrie","city_id":44827},{"id":10423,"nume":"1 Mai","city_id":69919},{"id":10455,"nume":"1 Mai","city_id":77821},{"id":10723,"nume":"1 Mai","city_id":120735},{"id":11018,"nume":"1 Mai","city_id":179132},{"id":11537,"nume":"1 Mai","city_id":69919},...

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!

Colecțiile folosite pentru id-urile parametrilor Ofera.ro

Sunt câțiva parametrii specifici folosiți pentru salvarea anunțurilor prin API astfel încât acestea să fie încadrate în mod corect în baza de date.

Imobiliare

Pentru imobiliare acești parametrii sunt reprezentați de city_id - id-ul localității și region_id - id-ul zonei din localitate.

Obținere informații localitate

Request ID list

Lista de id-uri este cea care va fi folosită să identifice localitatea în city_id.

GET https://admin.ofera.ro/api/v2.1/cities

Response

Request by ID

Informații detaliate despre fiecare localitate sunt incluse în cadrul cererii specifice după id, pentru situația în care sunt necesare la identificare.

GET https://admin.ofera.ro/api/v2.1/cities/__CITY_ID__

Response

{
    "id": 1026,
    "nume": "ALBA IULIA",
    "seo_key": "alba-iulia",
    "cod_postal": 0,
    "judet_id": 1,
    ...
}

Request with zones

GET https://admin.ofera.ro/api/v2.1/cities/__CITY_ID__/tree

Response

Obținere informații Județ

Request ID List

GET https://admin.ofera.ro/api/v2.1/counties

Response

[{"id":1,"nume":"Alba"},{"id":2,"nume":"Arad"},{"id":3,"nume":"Arges"},{"id":4,"nume":"Bacau"},{"id":5,"nume":"Bihor"},...

Request by ID

GET https://admin.ofera.ro/api/v2.1/counties/__COUNTY_ID__

Response

{
    "id": 1,
    "nume": "ALBA",
    "fsj": 1,
    "abr": "AB",
    ...
}

Request with cities

Încarcarea județului cu localitățile din acesta este modul recomandat pentru a vă putea configura eficient id-ul localității în city_id.