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ț
Activare anunț

Modificare anunț

Request:
PUT https://admin.ofera.ro/api/v1/update-product/__ID__
Headers:
Content-Type: application/json
Accept: application/json
Authorization: Bearer __access_token__
PUT data (json format) Response:
Notă:
  • Orice câmp al anunțului este editabil, în afară de ID.
  • Dacă parametrul images nu este prezent, se poate edita anunțul și imaginile vor rămâne neschimbate.
  • Dacă images este prezent, toate imaginile vor fi șterse și înlocuite cu cele noi (sau rămân șterse dacă este un array gol).
  • 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',
        "contact": {
            "person": Numele persoanei
        },
        "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
    }
    
    {
        "code": "SUCCESS",
        "message": "Updatat cu succes. Id Ofera.ro: 68452",
        "id": 68452,
        "status": 200
    }
Exemplu adăugare anunț
Activare anunț

Modificarea unui anunț cu ID prezent

  • Orice câmp al anunțului este editabil, în afară de ID.
  • Dacă parametrul images nu este prezent, se poate edita anunțul și imaginile vor rămâne neschimbate.
  • Dacă images este prezent, toate imaginile vor fi șterse și înlocuite cu cele noi (sau rămân șterse dacă este un array gol).
  • 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

PUT https://admin.ofera.ro/api/v2/update-product/__ID__
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": "Modificat cu succes.",
    "data": {
        "id": 52,
        "log_track_id": 8254211,
        "valabilitate": "23.09.2019"
    },
    "status": 200
}

Error Responses

{    
    "code": "ERROR",
    "message": "Nu a putut fi modificat.",
    "data": {
        "log_track_id": 8254217,
    },
    "status": 500
}
{    
    "code": "ERROR",
    "message": "Nu a putut fi gasit.",
    "data": {
        "log_track_id": 8254221,
    },
    "status": 404
}

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ț
Activare anunț

Modificarea unui anunț cu ID prezent

  • Orice câmp al anunțului este editabil, în afară de ID.
  • Dacă parametrul images nu este prezent, se poate edita anunțul și imaginile vor rămâne neschimbate.
  • Dacă images este prezent, toate imaginile vor fi șterse și înlocuite cu cele noi (sau rămân șterse dacă este un array gol).
  • 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

PUT https://admin.ofera.ro/api/v2.1/update-product/__ID__
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": "Modificat cu succes.",
    "data": {
        "id": 52,
        "log_track_id": 8254211,
        "valabilitate": "23.09.2019"
    },
    "status": 200
}

Error Responses

{    
    "code": "ERROR",
    "message": "Nu a putut fi modificat.",
    "data": {
        "log_track_id": 8254217,
    },
    "status": 500
}
{    
    "code": "ERROR",
    "message": "Nu a putut fi gasit.",
    "data": {
        "log_track_id": 8254221,
    },
    "status": 404
}
Acest site folosește cookies. Continuare navigării implică acceptarea lor.
ACCEPT