Šajā rakstā:

Plānojot API savienojuma izveidi ar MONEO lūdzam sekot zemāk minētajiem soļiem un ieteikumiem, kas nodrošinās stabilu, ātru, drošu un efektīvu datu apmaiņu.

Izplāno API darbības struktūru

Pirmais solis ir izplānot divu sistēmu savstarpējas datu apmaiņas struktūru: 

• Izveido sarakstu ar datu vienībām, ar kurām sistēmas apmainīsies un kādus biznesa procesus tas nodrošinās. Piemēram, produktu kataloga sinhronizācija, noliktavas atlikuma iegūšana, pasūtījumu ģenerēšana, noliktavas izmaiņas, jaunu klientu ģenerēšana. 
• Nosaki cik daudz API pieprasījumi laika vienībā būs nepieciešami katram no uzdevumiem.
• Nosaki cik bieži katrs no procesiem būs jāveic.

Šāds plāns nepieciešams, lai laicīgi identificētu, kuri procesi var sagādāt problēmas savstarpējā savietojamībā, kur ir pārāk liels datu apjoms vai pārāk liels pieprasījumu skaits laika vienībā.

• API lasīšanas (read) pieprasījumos var iegūt informāciju par vairākiem ierakstiem vienlaicīgi, piemēram, ierakstu sarakstu, noliktavas atlikumu par produktiem utml.
• API rakstīšanas (write/update) pieprasījumi var tikt veikti kā viens pieprasījums par vienu ierakstu.

Vienam uzņēmumam ir noteikts API pieprasījumu "budžets", kas pieejams šī uzņēmuma pieslēgumam. Šobrīd šo "budžetu" nosaka kā API pieprasījumu skaitu sekundē pēc slīdošā loga principa. Sīkāk skatīt šeit.

 

Plāno API pieprasījumus efektīvi

Ieplān API darbības tā, lai maksimāli efektīvi izmantotu API pieprasījumu budžetu. Piemēram:

• Dažādus darbus veic nodalītos laika periodos (time slots).
• Lielus, lēnus darbus nodali vienu no otra, lai dotu iespēju izmantot vairāk pieprasījumus laika periodā.
• Izlīdzini pieprasījumus visas dienas laikā. Darbus kurus iespējams atlikt, ieplāno mazākas aktivitātes stundās. Atceries MONEO serveris apkalpo uzņēmumam svarīgus ikdienas procesus noliktavā, grāmatvedība un ražošanā, tādēļ aktīvā darba laikā veic maksimāli mazāk pieprasījumu.

 

Pieprasi tikai to, kas ir nepieciešams

Veidojot API lasīšanas pieprasījumu, ir iespēja norādīt lauku sarakstu, kurus ir nepieciešams nolasīt. Tas var uzlabot lasīšanas pieprasījuma ātrdarbību - šāda pieprasījuma apstrāde ir ātrāka un datu pārsūtīšana pa tīklu aizņems mazāk laika. Tas jāņem vērā, jo virknei datu tabulu lauku skaits pārsniedz 100 un visi šie datu lauki nekad nav nepieciešami.

 

Izmaini tikai tās lietas, kas ir mainījušās

Līdzīgi kā ar lasīšanu, arī rakstīšanai ir lietderīgi iesūtīt tikai to lauku sarakstu, kas ir izmainījies. API write un update pieprasījumos var iesūtīt field_list parametru, kurā tiek noteikts, kuri lauki tiek sagaidīti.

MONEO datu izveides brīdī piemeklē visus saistītos ierakstu datus, ja tādi nepieciešami, lai izveidotu pilno ierakstu. Piemēram, iesūtot pieprasījumu par rēķina saglabāšanu, rēķina galvas informācija var saturēt tikai klienta kodu, datumu, jo pārējie dati tiek pielasīti pēc tabulu iekšējās loģikas.

Labs veids kā pārbaudīt savu pieprasījumu, kas tiek piemeklēts katrā datu lauka sarakstā, ir mēģināt attiecīgo ierakstu ievadīt manuāli MONEO lietotāja interfeisā - ja ievadot interesējošos laukus lietotāja interfeisā visi interesējošie, saistītie lauki ir aizpildījušies, tad ir pietiekami droši teikt, ka šie lauki aizpildīsies arī caur API saglabāšanas pieprasījumu.

 

Rēķinies ar asinhronu datu apmaiņu

MONEO API nevar tikt uzskatīts par datubāzi caur internetu. API saslēgums izmantojams kā risinājums divu patstāvīgu, neatkarīgu sistēmu saslēgšanai, ar ko tiek domāts, ka neviena no sistēmām nepārstāj darboties, ja otra sistēma nav pieejama. Tas var nozīmēt, ka pasūtījumu ģenerējošs interneta veikals pasūtījumus saglabā savā datubāzē un ievieto tos rindā uz nosūtīšanu uz MONEO. MONEO šie ieraksti var nonākt sekundes laikā, bet var arī prasīt stundu - viss atkarīgs no API izsaukumu biežuma un esošās citu lietotāju uzliktās slodzes uz sistēmu.

Jāņem vērā, ka MONEO strādā arī citi lietotāji, kuri var veikt apjomīgas datu manipulācijas, piemēram, masveida rēķinu ģenerēšanu, datu pārrēķinus utml. Šādas darbības noslēdz datu bāzi un ieliek rindā visas jaunas write/update/delete operācijas. Situācijā, kad datubāze ir noslēgta, API nepilda write/update/delete operācijas. Tai pat laikā - lasīšanas operācijas tiek izpildītas un uz to datu versiju, kas bija pirms sākās apkalpošanas funkcijas.