KKK - head tavad API kasutamiseks

Head tavad Standard Booksi Rest API kasutamiseks

Andmete maht

Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toiminguregistrid (arved, laekumised, tellimused, kanded jne). Et seda teha teiste kasutajate suhtes võimalikult väikese mõjuga, siis:

• Üle 100 000 kirjega registrite puhul kasutage andmete pärimiseks öist aega.
• Kui öine ajastamine pole võimalik, pärige andmeid näiteks 1000 kuni 5000 kaupa, kasutades offset and limit parameetreid. Jätke päringute vahele umbes sekundilised pausid, et server saaks vahepeal teenindada klientprogramme
• Kui kasutate suurte andmemahtude korral fields või filter parameetreid, on päringule vastuse koostamine äärmiselt CPU-nõudlik. Päringule vastuse koostamine võtab ca 10x kauem aega, kui pärides toor-andmeid. Antud filtreid on hea kasutada jooksvate päringutega, lühikese perioodi kohta või koos updates_after parameetriga.

Jooksvate päringute tegemine

• Veebipoodide, tootmis- ja laosüsteemide liidestamisel on vajadus pärida Standard Booksist muutunud andmeid. Selleks tegevuseks on parim viis updates_after parameetri kasutamine, mis tagastab vastuses vaid uued ja/või muutunud kaardid päritavas registris alates eelmisest päringust. NB: kui soovite kasutada updates_after parameetrit registris, kus see toetatud pole, siis võtke ühendust Excellenti müügiosakonnaga.
• Ajastage päring mitte sagedamalt, kui 20 minutilise intervalliga. Kui teete sagedamalt, hakkavad Stadard Booksis kuhjuma samaaegsed sisselogimis-sessioonid. 2021 lõpu seisuga on Standard Booksil probleeme suure hulga taoliste sessioonide haldamisega ja varem või hiljem tekivad probleemid klientprogrammide ühendustega.

Testid

Testid on tehtud 2021 aasta lõpus, ver STDBKS_8.5-2021-09-26-0383

• 2- realisi finantskandeid suudab Standard Books tavaolukorras kirjutada 10 tk sekundis.
• 1 realisi arveid koos Kinnita valikuga suudab Standard Books kirjutada 3-4 tk sekundis
• 10 000 kande pärimine toor-andmetega võtab aega ca 10 sekundit (3 sekundit päringu koostamine, 7 sekundit vastuse salvestamine + edastamine). Vastuse suurus 30 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
• 10 000 kande pärimine koos fields parameetri ja 10 väljaga võttis 7 sekundit (5 sekundit päringu koostamine, 2 sekundit vastuse salvestamine + edastamine) Vastuse suurus 4 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
• Kui teha GET päringuid järjest 1 sekundilise vahega, siis on klientprogramm kasutuskõlbmatu peale 25 minuti möödumisel päringute algusest.