Portal pentru dezvoltatori

Glosar

Partner — compania care construiește integrarea. Partner este responsabil pentru respectarea Termenilor și condițiilor Partner API, pentru soluția tehnică și pentru contactul tehnic legat de integrare.

Application (numită și Client în API) — software creat de Partner care apelează Partner API pentru integrarea cu OLX. Un Partner poate deține mai multe Applications. Fiecare Application are propriile credențiale (client_id / client_secret). Utilizatorii finali lucrează cu produsul Partnerului; Application este cea care comunică cu OLX în numele lor.

User (numit și vânzător sau lister) — persoană care folosește Application Partnerului și are un cont OLX. Prin Application, User poate publica anunțuri, citi statusuri și mesaje și folosi alte funcții OLX fără a accesa direct site-ul sau aplicația OLX. Când API-ul acționează „în numele unui utilizator”, înseamnă acest cont OLX — nu compania Partner.

Relație:

Partner → owns Application(s) / Client(s) → each Application acts on behalf of User(s) (sellers / listers)

flowchart LR
    Partner["Partner
companie / integrator"]
    App["Application
(Client în API)"]
    UA["User A
vânzător / lister"]
    UB["User B
vânzător / lister"]
    UMore["User …
conturi OLX"]
    Partner -->|deține| App
    App -->|acționează pentru| UA
    App -->|acționează pentru| UB
    App -->|acționează pentru| UMore

Exemplu

Partner Excellent and Beautiful Integrations Company (EBIC) creează două Applications:

• Excellent Stock Management
• Excellent Stock Management Premium

Aceste Applications îi ajută pe clienții EBIC să gestioneze inventarul. Una dintre funcții este vânzarea pe OLX.

Pentru ca un client EBIC să vândă pe OLX, persoana respectivă trebuie să aibă un cont OLX. În termeni API este User (vânzător / lister) — nu Client.

User se autentifică în Excellent Stock Management (sau Premium) și acordă acelei Application acces la contul OLX (consimțământ OAuth, inițiat de Application). După consimțământ, Application poate publica anunțuri, citi statusuri, primi mesaje de la cumpărători și folosi alte funcții Partner API în numele acelui User. Application stochează token-urile acelui User de partea sa.

În contul OLX, User vede Applications conectate și poate deconecta oricare dintre ele. După deconectare, acea Application nu mai poate folosi contul OLX. Un User poate conecta Applications de la mai mulți Partners.

Cine se înregistrează în Developer Portal?

Partner se înregistrează în Developer Portal (trebuie acceptați Termenii și condițiile Partner API). Apoi Partner își înregistrează Applications (Clients). Fiecare Application primește client_id și client_secret folosite în OAuth. Partner gestionează Applications, setările și utilizarea API.

User nu se înregistrează în Developer Portal. Users folosesc Application Partnerului și o autorizează să acceseze contul OLX. Sunt integrați prin fluxul de autentificare / consimțământ, nu prin portal.

Pentru OAuth, token-uri și modul în care Application apelează API-ul în numele unui User, consultați Autorizare în API.

Pentru detalii despre cereri, endpoint-uri și scope-uri, consultați secțiunea Authentication din documentația API.

Pentru a vă înregistra ca Partner și a crea o Application, urmați Obținerea accesului la API.