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! If you are currently setting query limits via the request body, we recommend moving them to the URL instead.
Starting mid-2026, all API requests will be subject to default limits if no explicit limit is provided. Support for defining limits via the request body will be discontinued
Jei turite daugiau klausimų, prašome susisiekti el. paštu support@alldevice.com