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.

Obținere câmpuri parametrizate pentru o categorie

Request:
GET https://admin.ofera.ro/api/v1/categories/__ID__
Headers:
Content-Type: application/json
Accept: application/json
Response:
    {
        "id": 92,
        "names": {
            "ro": "Apartamente - Garsoniere de vânzare"
        },
        "code": "apartamente-garsoniere-de-vanzare",
        "children": [
            93,
            94,
            95,
            96
        ],
        "path_url": "imobiliare/apartamente-garsoniere-de-vanzare",
        "depth": 2,
        "parameters": [
            {
                "code": "price",
                "type": "price",
                "required": true,
                "options": {
                    "price": {
                        "ro": "pret"
                    }
                }
            },
            {
                "code": "negotiable",
                "type": "checkbox",
                "labels": {
                    "ro": "Negociabil"
                },
                "required": false,
                "options": null
            },
            {
                "code": "accepts_swap",
                "type": "checkbox",
                "labels": {
                    "ro": "Schimb"
                },
                "required": false,
                "options": null
            },
            {
                "code": "net_area",
                "type": "input",
                "labels": {
                    "ro": "Suprafața utilă"
                },
                "required": true,
                "options": null
            },
            {
                "code": "construction_year",
                "type": "input",
                "labels": {
                    "ro": "Anul constructiei"
                },
                "required": false,
                "options": null
            },
            {
                "code": "floor_no",
                "type": "select",
                "labels": {
                    "ro": "Etaj"
                },
                "required": false,
                "options": {
                    "demisol": {
                        "ro": "Demisol"
                    },
                    "parter": {
                        "ro": "Parter"
                    },
                    "fl_1": {
                        "ro": "1"
                    },
                    "fl_2": {
                        "ro": "2"
                    },
                    "fl_3": {
                        "ro": "3"
                    },
                    "fl_4": {
                        "ro": "4"
                    },
                    "fl_5": {
                        "ro": "5"
                    },
                    "fl_6": {
                        "ro": "6"
                    },
                    "fl_7": {
                        "ro": "7"
                    },
                    "fl_8": {
                        "ro": "8"
                    },
                    "fl_9": {
                        "ro": "9"
                    },
                    "fl_10": {
                        "ro": "10"
                    },
                    "fl_11": {
                        "ro": "11"
                    },
                    "fl_12": {
                        "ro": "12"
                    },
                    "fl_13": {
                        "ro": "13 si peste"
                    },
                    "mansarda": {
                        "ro": "Mansarda"
                    }
                }
            },
            {
                "code": "divisioning_type",
                "type": "select",
                "labels": {
                    "ro": "Compartimentare"
                },
                "required": false,
                "options": {
                    "detached": {
                        "ro": "decomandat"
                    },
                    "semidetached": {
                        "ro": "demidecomandat"
                    },
                    "undetached": {
                        "ro": "nedecomandat"
                    },
                    "circular": {
                        "ro": "circular"
                    }
                }
            }
        ]
    }
    

Obținere câmpuri parametrizate pentru o categorie

Fiecare categorie are acces să modifice câmpurile ei specifice și unele din câmpurile categoriei părinte. Prin accesarea ei în API se pot vedea toate aceste câmpuri.

Request

GET https://admin.ofera.ro/api/v2/categories/__ID__
Headers:
Content-Type: application/json
Accept: application/json

Response

{
    "id": 92,
    "name": "Apartamente - Garsoniere de vânzare",
    "code": "apartamente-garsoniere-de-vanzare",
    "children"[
        93,
        94,
        95,
        96
    ],
    "path_url": "imobiliare/apartamente-garsoniere-de-vanzare",
    "depth": 2,
    "parameters"[
        {
            "code": "price",
            "type": "number",
            "label": "Pret",
            "required": true,
            "options": null
        },
        {
            "code": "negotiable",
            "type": "checkbox",
            "label": "Negociabil",
            "required": false,
            "options": null
        },
        {
            "code": "accepts_swap",
            "type": "checkbox",
            "label": "Schimb",
            "required": false,
            "options": null
        },
        {
            "code": "latitude",
            "type": "number",
            "label": "Latitude",
            "required": false,
            "options": null
        },
        {
            "code": "longitude",
            "type": "number",
            "label": "Longitude",
            "required": false,
            "options": null
        },
        {
            "code": "region_id",
            "type": "dropdown",
            "label": "Zona",
            "required": false,
            "options": null
        },
        {
            "code": "c_suprafata_utila",
            "type": "text",
            "label": "Suprafața utilă",
            "required": false,
            "options": null
        },
        {
            "code": "c_an_constructie",
            "type": "text",
            "label": "An construcție",
            "required": false,
            "options": null
        },
        {
            "code": "c_etaj",
            "type": "dropdown",
            "label": "Etaj",
            "required": false,
            "options"{
                "1": "1",
                "2": "2",
                "3": "3",
                "4": "4",
                "5": "5",
                "6": "6",
                "7": "7",
                "8": "8",
                "9": "9",
                "10": "10 și peste",
                "100": "Demisol",
                "101": "Parter",
                "200": "Mansardă"
            }
        },
        {
            "code": "c_compartimentare",
            "type": "dropdown",
            "label": "Compartimentare",
            "required": false,
            "options"{
                "1": "Decomandat",
                "2": "Semidecomandat",
                "3": "Nedecomandat",
                "4": "Circular"
            }
        }
    ]
}

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!

Obținere câmpuri parametrizate pentru o categorie

Fiecare categorie are acces să modifice câmpurile ei specifice și unele din câmpurile categoriei părinte. Prin accesarea ei în API se pot vedea toate aceste câmpuri.

Request

GET https://admin.ofera.ro/api/v2.1/categories/__ID__
Headers:
Content-Type: application/json
Accept: application/json

Response

{
    "id": 92,
    "name": "Apartamente - Garsoniere de vânzare",
    "code": "apartamente-garsoniere-de-vanzare",
    "children"[
        93,
        94,
        95,
        96
    ],
    "path_url": "imobiliare/apartamente-garsoniere-de-vanzare",
    "depth": 2,
    "parameters"[
        {
            "code": "price",
            "type": "number",
            "label": "Pret",
            "required": true,
            "options": null
        },
        {
            "code": "negotiable",
            "type": "checkbox",
            "label": "Negociabil",
            "required": false,
            "options": null
        },
        {
            "code": "accepts_swap",
            "type": "checkbox",
            "label": "Schimb",
            "required": false,
            "options": null
        },
        {
            "code": "latitude",
            "type": "number",
            "label": "Latitude",
            "required": false,
            "options": null
        },
        {
            "code": "longitude",
            "type": "number",
            "label": "Longitude",
            "required": false,
            "options": null
        },
        {
            "code": "region_id",
            "type": "dropdown",
            "label": "Zona",
            "required": false,
            "options": null
        },
        {
            "code": "c_suprafata_utila",
            "type": "text",
            "label": "Suprafața utilă",
            "required": false,
            "options": null
        },
        {
            "code": "c_an_constructie",
            "type": "text",
            "label": "An construcție",
            "required": false,
            "options": null
        },
        {
            "code": "c_etaj",
            "type": "dropdown",
            "label": "Etaj",
            "required": false,
            "options"{
                "1": "1",
                "2": "2",
                "3": "3",
                "4": "4",
                "5": "5",
                "6": "6",
                "7": "7",
                "8": "8",
                "9": "9",
                "10": "10 și peste",
                "100": "Demisol",
                "101": "Parter",
                "200": "Mansardă"
            }
        },
        {
            "code": "c_compartimentare",
            "type": "dropdown",
            "label": "Compartimentare",
            "required": false,
            "options"{
                "1": "Decomandat",
                "2": "Semidecomandat",
                "3": "Nedecomandat",
                "4": "Circular"
            }
        }
    ]
}
Acest site folosește cookies. Continuare navigării implică acceptarea lor.