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