API
Apie
API yra standartinė aplikacija skirta Alio.lt verslo klientams. Tai naudingas įrankis, suteikiantis galimybę patogiai ir greitai tvarkyti didesnius kiekius skelbimų.
API funkcionalumas
API standartu bendraujančios aplikacijos realiu laiku gali atlikti šias skelbimų valdymo funkcijas Alio.lt portale:
- Gauti visų kliento skelbimų sąrašą
- Gauti visų kliento skelbimų kategorijų sarašą
- Gauti kliento skelbimo informaciją
- Gauti skelbimo originalią (canonical) nuorodą
- Atnaujinti, ištrinti, paslėpti ir atnaujinti skelbimą
API funcijos
login
API prisijungimo funkcija. Prisijungę gaunate access_code, kuris yra reikalingas norint naudotis visomis kitomis funkcijomis. Access_code turi galiojimo laiką - 7200 sek. Parametrai yra priimami per GET parametrus: userinput (telefonas arba patvirtintas el.pašto adresas), password (slaptažodis).
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/login.html?userinput=pagalba%40alio.lt&password=1234567890
getAdsList
Gauti visų skelbimų ad_id sąrašą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdsList.html?access_code=asd123QWE&page=1
getAdData
Gauti pagrindinę skelbimo informaciją.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdData.html?access_code=asd123QWE&ad_id=123456
getAdvertiseByParentId
Gauti skelbimo informaciją pagal kliento sistemos ID ir Alio.lt XML_ID.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdvertiseByParentId.html?access_code=asd123QWE&xml_id=1234&id=1234
getAdCanonical
Gauti originalią (canonical) nuorodą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdCanonical.html?access_code=asd123QWE&ad_id=123456
renewAd
Funkcija skirta skelbimo atnaujinimui.
Atnaujinti skelbimą.
https://www.alio.lt/public/api/renewAd.html?access_code=asd123QWE&ad_id=123456
hideAd
Paslėpti skelbimą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/hideAd.html?access_code=asd123QWE&ad_id=123456
activateAd
Aktyvuoti skelbimą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/activateAd.html?access_code=asd123QWE&ad_id=123456
deleteAd
Ištrinti skelbimą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/deleteAd.html?access_code=asd123QWE&ad_id=123456
getCategories
Gauti kategorijų sąrašą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getCategories.html?access_code=asd123QWE
getCategoryAds
Gauti kategorijos skelbimų sąrašą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getCategoryAds.html?access_code=asd123QWE&category_id=1373&page=1
createAdvertise
Tuščiam skelbimui sukurti.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/createAdvertise.html?access_code=asd123QWE&category_id=123456
getOutputs
Skelbimo laukų informacijos gavimas. Reikalingas naujo skelbimo sukurymui ir skelbimo redagavimui.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getOutputs.html?access_code=asd123QWE&category_id=123456&ad_id=123456
updateAdvertise
Skelbimo informacijai pakeisti / paredaguoti skelbimą.
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/updateAdvertise.html
Informacijos siūntimo per POST pavyzdys:
array(3) {
["access_code"]=>
string(9) "asd123QWE"
["data"]=>
array(2) {
["text"]=>
array(2) {
["...1"]=>
string(3) "..."
["...2"]=>
string(3) "..."
}
["id"]=>
array(2) {
["...1"]=>
string(3) "..."
["...2"]=>
string(3) "..."
}
}
["ad_id"]=>
string(6) "123456"
}
getAdPhotos
Gauti skelbimo nuotraukų sarašą
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdPhotos.html?access_code=asd123QWE&ad_id=123456
getAdStats
Gauti skelbimo statistiką
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/getAdStats.html?access_code=asd123QWE&ad_id=123456
addAdPhoto
Nuotraukos įkelimas
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/addAdPhoto.html?access_code=asd123QWE&ad_id=123456&photo=http%3A%2F%2Fwww.example.com%2Fimage.png
deleteAdPhoto
Nuotraukos trynimas
Funkcijos nuorodos naudojimo pavyzdys:
https://www.alio.lt/public/api/deleteAdPhoto.html?access_code=asd123QWE&ad_id=123456&photo_id=123456
Naudojimasis aplikacija yra
NEMOKAMAS iki 10.000 skelbimų ir nedaugiau 50.000 užklausų per dieną.
Norit API pagalba tvarkyti didesnį nei 10.000 skelbimų kiekį, taikomus įkainius rasite čia:
API kainodara