Kui lood integratsiooni Alldevice ja mõne muu tarkvara vahel, palun arvesta järgmiste punktidega.
- Kui hakkad ehitama integratsiooni, loo Alldevice keskkonnas API ühendusele oma kasutaja ning kasutajagrupp (privileegid). Nimeta need sellisena, et kõigile oleks aru saada, milleks see kasutaja või õiguste grupp loodi.
On ette tulnud juhtumeid, kus mõni teine kasutaja on vaadanud kasutajate või gruppide nimekirja, omaette lausunud “meil sellist küll ei tööta” ning need kustutanud. - Päringute tegemisel kasuta alati limiite. Vaikimisi on soovituslik maksimaalne korraga päritavate ridade arv 200. Kui API dokumentatsiooni päringu kirjelduses on väiksem või suurem number, kasuta seda. Näiteks
/api/tasks/list?limit=200&start=0
Päringu vastuse on alati kirjas millised read anti ning kui palju ridu on saadaval. Selle järgi saate välja arvutada, mitu päringut saata tuleks.
- Ära saada paralleelselt üle kolme päringu korraga. Oota ära eelmise päringu vastus ning seejärel saada järgmine.
- Saada päringud põhjendatud regulaarsusega. Igaks-juhuks kõik päringud loop’i panna või iga minuti järel korrata pole mõistlik.
Täna Alldevice automaatseid piiranguid ei rakenda, kui ülaltoodud punktide vastu eksitakse. Piirangud tekkivad lähitulevikus. Parem on nendega juba täna arvestada, et tulevikus ei peaks ringi tegema.
NB! Kui kasutate sõnumi sisest päringu limiidi saatmis, soovitame need aadressile (url) üle viia. 2026a keskel rakenduvad kõikidele API päringutele vaikimisi limiidid (kui limiiti ei ole päringuga kaasa antud). Sõnumi sisu (body) kaudu limiidi määramise tugi kaob.
Lisaküsimuste korral saada meile kiri support@alldevice.com