Integruojant Alldevice su kita programine įranga, prašome atsižvelgti į sekančius punktus.
- Prieš pradedant kurti integraciją, prašome susikurti papildomą dedikuotą vartotoją ir vartotojų grupę (su atitinkamomis teisėmis), skirtą „API” jungčiai su Alldevice aplinka. Suteikite jam atitinkamą aprašymą ar pavadinimą, taip, kad kitiems vartotojams būtų aiški šio vartojo ir grupės paskirtis.
- Pagal nutylėjimą, vienoje „API” užklausoje norimas gauti rekomenduojamas maksimalus duomenų eilučių skaičius yra 200. Net jei „API” dokumentacijoje konkrečiam „endpoint” bus nurodytas didesnis ar mažesnis skaičius, visvien naudokite tą patį 200. Pavyzdžiui: /api/tasks/list?limit=200&start=0
„API” užklausos atsakyme visuomet bus įtraukta informacija apie tai, kiek eilučių atvaizduota šiai užklausai ir kiek jų yra iš viso. Remiantis tuo, galite pasiskaičiuoti, kiek iš viso „API” užklausų reikės siųsti.
- Nesiųskite daugiau, nei trijų „API” užklausų vienu metu. Išlaukite kiekvienos užklausos atsakymo, prieš siunčiant sekančią užklausą.
- Užklausas siųskite logišku, saikingu dažnumu. Pavyzdžiui nerekomenduojama sukelti visas užklausas į vieną ciklą ir „dėl viso pikto” kartoti kas minutę.
Šiuo metu, Alldevice automatiškai dar nebus automatiškai apribojama vartotojo prieiga, jei nebus laikomasi šių gairių. Tačiau tokie apribojimai bus įdiegti artimiausiu metu. Todėl verčiau laikytis aprašytų rekomendacijų jau dabar, siekiant išvengti būtinybės perdaryti jau sukurtą inegraciją ateityje.
Pastaba! Jei šiuo metu API užklausai, nustatant prašomų duomenų eilučių kiekį, ribas įvedate pagal ankstesnėje dokumentacijoje nurodytą aprašymą, per užklausos turinį, tuomet rekomenduojame tai pakeisti, kaip yra nurodyta naujoje dokumentacijoje, ribas įvedant per URL.
Pradedant nuo 2026 metų vidurio, visos API užklausoms, pagal nutylėjimą jau bus ribojamas eilučių kiekis, jei iki šiol jokia riba nebuvo nustatyta. Užklausos ribų nustatymas, naudojant ribų parametrus užklausos turinyje, jau nebus palaikomas.
Jei turite daugiau klausimų, prašome susisiekti el. paštu lithuania@alldevice.com