Documentație API Ofera.ro

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},...