МойСклад API шектеулері және сенімді дерек алмасуды қалай ұйымдастыру керек
Мазмұны
МойСклад-пен интеграция әдетте оңай басталады: ашық API, түсінікті құжаттама, вебхуктар. Мәселелер каталог, тапсырыстар саны және қосылған жүйелер саны өскен кезде пайда болады. Сол кезде интеграция лимиттерге тіреліп, өзгерістерді жоғалта бастайды немесе баяулайды.
Бұл мақала осындай мәселелерге тап болғандарға немесе олардың алдын алғысы келетіндерге арналған.
Қандай шектеулер кездеседі
Сұраулар санына қойылатын лимиттер
МойСклад API белгілі бір кезеңдегі сұраулар санына және параллель сұраулар санына шектеу қояды. Лимит асқан кезде сервер қате қайтарады, ал сұрауды кейінірек қайталау қажет. Лимиттердің ағымдағы мәндері API құжаттамасында көрсетілген.
Бір жауаптағы деректер көлемі
Тізімдер бөліктермен қайтарылады, сондықтан каталогты толық шығарып алу үшін көптеген сұрауды ретімен жіберу қажет.
Вебхуктар
Өзгерістер туралы хабарламалар жүйеге үнемі сұрау жібермеуге мүмкіндік береді, бірақ әр оқиғаның жеткізілуіне кепілдік бермейді. Қосымша салыстырып тексеру қажет.
Аккаунтқа ортақ лимиттер
Бір МойСклад аккаунтына бірнеше интеграция (сайт, портал, CRM, жеткізу сервисі) қосылса, олар ортақ лимитті бөліседі. Лимитті көп тұтынатын бір интеграция басқаларына кедергі келтіруі мүмкін.
Жиі кездесетін белгілер
- порталдағы тауар қалдықтары ұзақ кідіріспен жаңартылады;
- баға өзгерістерінің бір бөлігі жетпейді;
- интеграция лимиттен асу қателеріне байланысты мерзімді түрде істен шығады;
- түнгі толық дерек шығару аяқталып үлгермейді;
- жаңа интеграция қосылғаннан кейін бұрынғылары нашар жұмыс істей бастайды.
Сенімді дерек алмасу қағидаттары
- Барлық деректі түгел емес, өзгерістерді жіберу. Деректерді толық шығару тек бастапқы жүктеу және сирек жүргізілетін салыстырып тексеру үшін қажет.
- Вебхуктарды салыстырып тексерумен бірге пайдалану. Вебхуктар жылдамдықты, ал салыстырып тексеру толықтықты қамтамасыз етеді.
- Деректердің көшірмесін өз жағыңызда сақтау. Пайдаланушы әр әрекет жасаған сайын портал МойСклад-тен емес, өз дерекқорынан оқиды.
- Сұраулардың басымдығын белгілеу. Тапсырыс жасау сипаттамаларды жаңартудан маңыздырақ.
- Кідірістен кейін қайталау. Лимит қатесі туындағанда сұрауды бірден қайталамай, кідірісті ұлғайту керек.
- Журналға тіркеу. Әр операция мәртебесімен және қатесімен бірге жазылады.
- Интеграцияларды біріктіру. Әр жүйені МойСклад-ке жеке қоспау керек.
Бұл қай кезде күрделі мәселеге айналады
- модификациялары бар ондаған мың позициядан тұратын каталог;
- күніне жүздеген тапсырыс;
- бағалар мен тауар қалдықтарының жиі өзгеруі;
- бірнеше арна: портал, сайт, CRM, жеткізу сервистері.
Жиі қойылатын сұрақтар
Лимиттерді арттыруға бола ма?
Шарттар МойСклад пен тарифке байланысты. Алайда лимиттер жоғары болған күннің өзінде дерек алмасудың дұрыс архитектурасы қажет.
Вебхуктар неге келмейді?
Себептері әртүрлі: өңдегіштің қолжетімсіздігі, жауаптың ұзақ күтілуі, сервис тарапындағы қателер. Сондықтан вебхуктар әрдайым салыстырып тексерумен толықтырылады.
Қолданыстағы интеграцияны түзетуге бола ма?
Әдетте болады: дерек алмасуды өзгерістерді жіберуге көшіреді, кезек, қайталау және салыстырып тексеру тетіктерін қосады.
