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.

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": Numele anunțului,
        "description": Descrierea anunțului,
        "category_id": Id-ul categoriei pentru încadrare,
        "images": [
            {
                "url": Url-ul imaginii,
                "order": Poziția pe care va fi imaginea 
                         (0 - prima va fi si principala)
            },
            [...]
        ],
        "city_id": ID-ul localitații,
        "region_id": ID-ul zonei,
        "coordinates": {
            "latitude": XX.XXXXXX,
            "longitude": XX.XXXXXX
        },
        "advertiser_type": Tipul persoanei de contact, 
                           'private' sau 'business',
        "params": {
            ... parametrii categoriei de încadrare
        },
        "agent": {
            "name": Nume agent,
            "email": Emailul la care poate fi contactat,
            "phone": Numărul de telefon de contact,
            "photo": Url către poza agentului (dacă există)
        },
        "external_id": ID-ul extern al anunțului,
        "promoted": (1 - daca e promovat, 0 - daca nu. 
                     Anunturile promovate ocupa sloturi 
                     de promovare)
    }
    
    {
        "code": "SUCCESS",
        "message": "Adaugat cu succes. Id Ofera.ro: 52",
        "id": 52,
        "status": 200
    }
    

Adăugarea unui anunț

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ă.

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": Numele anunțului,
    "description": Descrierea anunțului,
    "category_id": Id-ul categoriei pentru încadrare,
    "city_id": ID-ul localitații,
    "images"[
        {
            "url": Url-ul imaginii,
            "order": Poziția pe care va fi imaginea 
                     ( 0 - prima va fi si principala )
        },
        [...]
    ],
    "contact"{
        "tip": Tipul persoanei de contact, 
                "private" sau "business",
        "name": Nume persoana de contact,
        "email": Emailul la care poate fi contactat,
        "phone": Numărul de telefon de contact,
        "photo": Url către poza persoanei de contact (dacă există)
    },
    "params"{
        ... parametrii categoriei de încadrare
    },
    "external_id": ID-ul extern al anunțului,
    "promoted": ( 1 - daca e promovat, 0 - daca nu. 
                 Anunturile promovate ocupa sloturi 
                 de promovare )
}

Response

{
    "code": "SUCCESS",
    "message": "Adaugat cu succes. Id OFERA.ro: 52",
    "data"{
        "id": 52,
        "log_track_id": 8254215,
        "valabilitate": "23.09.2019",
        "url": "https://www.ofera.ro/anunt/numele-anuntului-ID52"
    },
    "status": 200
}

Error Responses

{    
    "code": "ERROR",
    "message": "Nu a putut fi adaugat.",
    "data"{
        "log_track_id": 8254216,
    },
    "status": 500
}

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!

Adăugarea unui anunț

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ă.

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": Id-ul celui care deține anunțul,
    "title": Numele anunțului,
    "description": Descrierea anunțului,
    "category_id": Id-ul categoriei pentru încadrare,
    "city_id": ID-ul localitații,
    "images"[
        {
            "url": Url-ul imaginii,
            "order": Poziția pe care va fi imaginea 
                     ( 0 - prima va fi si principala )
        },
        [...]
    ],
    "contact"{
        "tip": Tipul persoanei de contact, 
                "private" sau "business",
        "name": Nume persoana de contact,
        "email": Emailul la care poate fi contactat,
        "phone": Numărul de telefon de contact,
        "photo": Url către poza persoanei de contact (dacă există)
    },
    "params"{
        ... parametrii categoriei de încadrare
    },
    "external_id": ID-ul extern al anunțului,
    "promoted": ( 1 - daca e promovat, 0 - daca nu. 
                 Anunturile promovate ocupa sloturi 
                 de promovare )
}

Response

{
    "code": "SUCCESS",
    "message": "Adaugat cu succes. Id OFERA.ro: 52",
    "data"{
        "id": 52,
        "log_track_id": 8254215,
        "valabilitate": "23.09.2019",
        "url": "https://www.ofera.ro/anunt/numele-anuntului-ID52"
    },
    "status": 200
}

Error Responses

{    
    "code": "ERROR",
    "message": "Nu a putut fi adaugat.",
    "data"{
        "log_track_id": 8254216,
    },
    "status": 500
}
Acest site folosește cookies. Continuare navigării implică acceptarea lor.