Skip to main content
Басты бетБлогНұсқаулықтарAPI арқылы синхрондалған тасымалдаушының соңғы бақылау оқиғаларын тексеруге арналған 6 тексеріс

API арқылы синхрондалған тасымалдаушының соңғы бақылау оқиғаларын тексеруге арналған 6 тексеріс

17TRACK

API жүйеңіздің тасымалдаушының соңғы бақылау оқиғаларын синхрондағанын тексеру үшін жөнелтілім идентификаторын, оқиғалардың уақыт белгілерін, оқиға мәліметтерін, жеткізу бағытын, оқиғалардың ретін және деректердің жаңалығын тәуелсіз бақылау көрінісімен салыстырыңыз. API жауабының сәтті болуы немесе webhook растауы осы тізбектің тек бір бөлігін ғана растайды; мұның өзі қолданбаңызда тасымалдаушының ең жаңа оқиғасы бар екенін дәлелдемейді.

Тасымалдаушының соңғы бақылау оқиғаларының синхрондалғанын тексерудің 6 тәсілі

Бұл нұсқаулық бақылау деректерін тапсырыстарды басқару жүйесіне, клиенттер көретін бетке, қолдау құралына немесе ескерту жұмыс процесіне жеткізуге жауапты әзірлеушілер мен операциялық топтарға арналған. Мақсат — оқиғаның қай жерде жоғалғанын немесе өзгергенін анықтап, өңдеуді қайталау, сәйкестендіруді түзету немесе тасымалдаушыдан жаңа ақпарат күту керектігін шешу.

Бастамас бұрын: «ең соңғы» дегеннің нені білдіретінін анықтаңыз

Үш уақытты бөлек қарастырыңыз: тасымалдаушы оқиға орын алды деп көрсеткен уақыт, бақылау провайдері оны алған немесе қолжетімді еткен уақыт және қолданбаңыз оны сақтаған уақыт. Бұл уақыттар әртүрлі болуы мүмкін. Тасымалдаушы сканерлеу нәтижесін нақты оқиғадан кейін жариялауы мүмкін, ал интеграцияңыз оны одан да кеш өңдеуі ықтимал. Сондықтан орын алу уақыты бойынша ең жаңа оқиға ең соңғы алынған жазба болмауы мүмкін.

Зерттеуді бастамас бұрын салыстыру нүктесін таңдаңыз. Ең дұрысы — сол жөнелтілімге қатысты тасымалдаушының бақылау бетін немесе тасымалдаушы ұсынған басқа өкілетті жазбаны пайдалану. Ол қолжетімсіз болса, қолданбаңызды бақылау провайдерінің ағымдағы API жауабымен салыстырыңыз. Бұл тар салыстыру қолданбаңыздың провайдерге сәйкес келетінін анықтай алады, бірақ провайдерде тасымалдаушының барлық сканерлеу нәтижелері бар екенін дәлелдей алмайды. Салыстыруды қашан жасағаныңызды жазып қойыңыз, сонда кейінгі жаңарту алдыңғы нәтижені сәйкессіз етіп көрсетпейді.

1. Екі жүйенің де бір жөнелтілімге қатысты екенін растаңыз

Интеграцияңыз пайдаланатын бақылау нөмірінен, тасымалдаушыдан және кез келген есептік жазба немесе жөнелтілім идентификаторынан бастаңыз. Ақауларды жою үшін бақылау нөмірінің өзі жеткіліксіз болуы мүмкін: нөмір қате енгізілуі, қате тасымалдаушымен байланыстырылуы немесе тапсырыс өзгертілгеннен кейін ішкі жазбада қайта пайдаланылуы мүмкін. Тапсырыс нөмірі мен бақылау нөмірінің мақсаттары да әртүрлі. Бір тапсырыста бірнеше сәлемдеме болуы мүмкін, сондықтан тапсырыстың соңғы күйін тексеру ескірген сәлемдемені байқатпай қалуы ықтимал.

  • Бақылау API қызметіне жіберілген нақты бақылау нөмірі мен тасымалдаушыны табыңыз.
  • Жауапты қай ішкі жөнелтілім немесе сәлемдеме жазбасы алғанын растаңыз.
  • Тіркелгеннен кейін жөнелтілімнің ауыстырылғанын, бөлінгенін, тоқтатылғанын немесе қайта байланыстырылғанын тексеріңіз.
  • Бастапқы жазбада көрсетілген тасымалдаушы мен нөмірді қолданбаңыздағы мәндермен салыстырыңыз.

Идентификаторлар сәйкес келмесе, айырмашылықты синхрондау кідірісі деп қарастыруды тоқтатыңыз. Алдымен байланысты түзетіп, содан кейін оқиғаларды салыстыруды қайталаңыз. Құпия есептік жазба деректерін журналдарға енгізбей, жөнелтілімді бақылауға жеткілікті идентификаторларды диагностикалық журналдарда сақтаңыз.

2. Мағынасын жоғалтпай, оқиғалардың уақыттарын салыстырыңыз

Әр ықтимал соңғы оқиға үшін тасымалдаушы хабарлаған орын алу уақытын, көрсетілген уақыт белдеуін немесе ығысуын (егер берілсе), сондай-ақ қолданбаңыздың қабылдау және сақтау уақыттарын тіркеңіз. Салыстыру үшін уақыт белгілерін ортақ уақыт негізіне түрлендіріңіз, бірақ бастапқы мәнді сақтаңыз. RFC 3339 ығысуы нақты көрсетілген интернет уақыт белгісі пішімін анықтайды; ол өз уақыт өрістеріңізді жобалау кезінде пайдалы анықтамалық болып табылады. Дегенмен ол тасымалдаушы немесе провайдер әр оқиға үшін уақыт белдеуін береді деп кепілдік бермейді.

Тек уақытты көрсету, жергілікті уақыт белдеуін болжап қолдану немесе ығысуды үнсіз алып тастайтын талдаушы оқиғаны басқа күнге ауыстыруы немесе оны қате ретке орналастыруы мүмкін. Бастапқы дерек екіұшты жергілікті уақыт берсе, нақты UTC сәтін ойдан шығармай, салыстыруды белгісіз деп белгілеңіз. Сондай-ақ оқиғаның орын алу уақытын API жауабының уақытынан ажыратыңыз: қазір алынған жауапта бұрын болған оқиға болуы заңды.

Тасымалдаушы немесе провайдер көрінісін тексерген уақытты жазып қойыңыз. Егер бастапқы дерек API сұрауыңыздан кейін жаңа сканерлеу нәтижесін жарияласа, екі көріністің айырмашылығы алдыңғы сұраудың сәтсіз болғанын білдірмейді.

3. Тақырыптағы күйді ғана емес, оқиға деректерін тексеріңіз

Соңғы оқиғаның сипаттамасын, орналасқан жерін, тасымалдаушы күйін немесе кодын және жеткізуге қатысты кез келген өрістерін бастапқы жазбамен салыстырыңыз. «Жолда» сияқты қалыпқа келтірілген күй бірнеше түрлі сканерлеуді қорытындылауы мүмкін. Егер қолданбаңыз тек қорытындыны сақтаса, жаңа оқиға келгеніне қарамастан күй өзгермегендей көрінуі мүмкін.

Деректерді өңдеу ережелері рұқсат етсе, API-дің бастапқы жауабын немесе сақталған webhook денесін тексеріңіз. Содан кейін оқиғаны талдау, өрістерді сәйкестендіру, сақтау және көрсету кезеңдері арқылы бақылаңыз. Null өрістердің әдепкі мәндермен алмастырылуын, күтпеген күй кодтарының жалпы санатқа түсуін, мәтіннің қысқартылуын немесе пайдаланушы интерфейсінің тек таңдалған оқиға түрлерін көрсетуін іздеңіз. Күй белгісінің сәйкессіздігі жоғалған оқиғадан өзгеше: ол жеткізуге емес, түрлендіру немесе көрсету логикасына нұсқайды.

Орналасқан жері немесе күйі соңғы кезеңді білдіретіндей көрінгендіктен ғана жеткізу болды деп қорытынды жасамаңыз. Жұмыс процесіңіз сүйенетін нақты оқиға мен өрістерді растаңыз. Керісінше, жоғары деңгейлі күйдің өзгермеуі синхрондау тоқтағанын дәлелдемейді; жаңадан алынған сканерлеу сол санатқа сәйкестенуі мүмкін. Диагностикалық жазба бастапқы оқиғаны да, пайдаланушыларға көрсетілген мәнді де сақтауы тиіс.

4. Оқиғаның қолданбаңызға қалай жеткенін қадағалаңыз

Webhook қолдансаңыз, тиісті жөнелтілім мен оқиғаға арналған қабылдау журналын тексеріңіз. Endpoint сұрауды қабылдағанын, хабарлама тексеруден өткенін және кейінгі өңдеу аяқталғанын растаңыз. Endpoint-іңіздің HTTP сәтті жауабы кейінгі кезек өңдеушісі оқиғаны сақтағанын дәлелдемейді. Өңдеу асинхронды болса, кіріс сұрауды да, тапсырма нәтижесін де зерттеңіз.

API-ді кезең-кезеңімен сұрасаңыз, соңғы аяқталған сұрауды, сол сұраудағы жөнелтілім идентификаторын, оның жауабын және интеграцияңыз пайдаланатын беттеу немесе алу логикасын тексеріңіз. Сәтті сұраудан кейін дерекқорға жазу сәтсіз болуы немесе ескірген кэш оқылуы мүмкін. Әр бақылау API қызметі бірдей келісімшартпен жұмыс істейді деп болжамай, интеграцияңыз үшін нақты жауап өрістерін, аутентификация талаптарын және жеткізу тәртібін тексеру үшін провайдердің тиісті құжаттамасын пайдаланыңыз. 17TRACK интеграциясы үшін бастапқы нүктелер — оның Tracking API беті және API құжаттамасы; пайдаланатын endpoint пен әдіс үшін құжатталған тәртіпті растаңыз.

Оқиғаларды өңдеуді қайталап орындауға қауіпсіз етіңіз. Қайта әрекет жасау қайталанатын сканерлеулерді тудырмауы, бір клиентке бір хабарландыруды қайта-қайта жібермеуі немесе жаңарақ сақталған күйді ескі деректермен алмастырмауы тиіс. Қайталанатын жазбаның тиісті кілті провайдер нақты ұсынатын өрістерге байланысты. Таңдалған кілтті күйі немесе уақыт белгісі бірдей болып кездейсоқ ұқсайтын әртүрлі оқиғаларда сынаңыз; олар тек ұқсас көрінгені үшін біріктірілмеуі керек.

5. Рет пен күй ауысу ережелерін тексеріңіз

Тіркелген оқиғаларды нақты анықталған ереже бойынша сұрыптап, нәтижені тексеріңіз. Көптеген қолданбаларда «орын алған соңғы оқиға» мен «біз алған соңғы оқиғаны» ажырату қажет. Бұрын болған сканерлеу жаңарақ сканерлеуден кейін келуі мүмкін. Егер дерекқор ең соңғы өңделген хабарламаны ағымдағы жөнелтілім күйі етсе, кеш келген сканерлеу көрсетілген күйді кері жылжытуы ықтимал.

Сақталған тарихты бір ғана күй өрісімен емес, бастапқы тарихпен салыстырыңыз. Жаңадан алынған жазбаның қосылғанын, қайталанатын ретінде жойылғанын немесе ағымдағы күйді жаңартуына рұқсат берілгенін анықтаңыз. Белгілі оқиғаларға басымдық беретін кез келген ережені тексеріңіз. Мұндай ереже әдейі енгізілуі мүмкін, бірақ ол бастапқы оқиғаны жасырмауы немесе қолданба ескі сканерлеуді кеш алған кезде тасымалдаушы межені кері қайтарды деген әсер қалдырмауы тиіс.

Практикалық сынақ үшін бірнеше оқиғасы бар жөнелтілімді алып, оның хабарламаларын өндірістік емес ортада басқа келу ретімен қайта ойнатыңыз. Оқиғалар тарихының толық сақталғанын және клиенттер көретін күйдің құжатталған ережеге сай келетінін растаңыз. Бұл қалыпты, ретімен жүргізілетін сынақ анықтай алмайтын ретке қатысты ақауларды ашады.

6. Деректердің жаңалығын өлшеп, ерекшеліктерді салыстырып тексеріңіз

Соңында әр қабаттың бір бақылау сәтінде не білгенін салыстырыңыз: тасымалдаушы көрінісі, бақылау провайдерінің жауабы, кіріс webhook немесе сұрау нәтижесі, дерекқор жазбасы және клиенттер көретін нәтиже. Күтілген оқиға алғаш жоғалған қабатты белгілеңіз. Бұл шекара «бақылау кешігіп жатыр» деген жалпы есептен пайдалырақ.

Тасымалдаушы хабарлаған соңғы оқиғаның жасын да, интеграцияңыздың деректерді соңғы рет сәтті тексергеніне немесе алғанына қанша уақыт өткенін де өлшеңіз. Олар әртүрлі сұрақтарға жауап береді. Интеграцияңыз дұрыс жұмыс істеп тұрса да, сәлемдемеде жаңа сканерлеу болмауы мүмкін; керісінше, тасымалдаушы жаңа сканерлеуді көрсетуі мүмкін, ал соңғы сәтті сұрауыңыз ескі болуы ықтимал. Өз операциялық талаптарыңыз бен байқалған тәртіпке сай ескерту шектерін қолданыңыз. Тасымалдаушы және провайдер келісімдеріңіз қолдамайтын болса, клиенттерге тұрақты жаңарту аралығын уәде етпеңіз.

Жазбалары таңдалған салыстыру көзімен ерекшеленетін жөнелтілімдер үшін шағын салыстырып тексеру кезегін жасаңыз. Оған идентификаторларды, жоғалған немесе сәйкес келмейтін оқиғаны, тиісті уақыт белгілерін, алғашқы ақаулы қабатты және келесі әрекетті қосыңыз. Мысалы, провайдер жауабында бар, бірақ дерекқорыңызда жоқ оқиға интеграцияны зерттеуді қажет етеді. Дерекқорыңызда бар, бірақ бақылау бетінде жоқ оқиға көрсету немесе кэшті тексеруді қажет етеді. Егер тасымалдаушының өзінде жаңа сканерлеу болмаса, басқа API сұрауы оны жасай алмайды.

Операциялық сынақ қарапайым: бір жөнелтілімді анықтап, оның бастапқы деректегі соңғы белгілі оқиғасын тауып, мағынасын өзгертпей сол оқиғаны пайдаланушы көретін көрініске дейін бақылай аласыз ба? Егер олай болмаса, осы алты тексеріс мәселені нақты шекараға дейін тарылтып, тобыңызға негізделген келесі қадамды ұсынады.

Жиі қойылатын сұрақтар

Сәтті webhook жауабы соңғы оқиғаның синхрондалғанын білдіре ме?

Жоқ. Бұл тек endpoint-іңіздің сұрауға сәтті жауап қайтарғанын көрсетеді. Тексеру, кезекті өңдеу, дерекқорда сақтау және көрсету кезеңдерінің де сәтті аяқталғанын растаңыз. Сұрауда қандай оқиға болғанын анықтау үшін деректерді тексеріңіз.

Неліктен тасымалдаушы бетінде API жауабымнан жаңарақ сканерлеу көрсетіледі?

Алдымен бір сәлемдемені көріп отырғаныңызды және екі бақылау да салыстыруға болатын уақытта жасалғанын растаңыз. Тасымалдаушының жариялауы мен бақылау провайдерінің оқиғаны алуы немесе көрсетуі әртүрлі уақытта орын алуы мүмкін. Айырмашылық сақталса, жаңарту кепілдігі бар деп болжамай, нақты жөнелтілімді зерттеу үшін провайдердің құжаттамасы мен қолдау процесін пайдаланыңыз.

Соңғы күйді таңдау үшін оқиға уақыт белгісін немесе жүйем оны алған уақытты пайдалануым керек пе?

Жұмыс процесіңізге сәйкес құжатталған ережені қолданыңыз және екі мәнді де сақтаңыз. Оқиға уақыт белгісі хабарланған әрекеттің қашан болғанын сипаттайды; қабылдау уақыты жүйеңіздің ол туралы қашан білгенін көрсетеді. Әсіресе бастапқы уақыттар екіұшты болғанда немесе бұрынғы сканерлеулер кеш келгенде, бұл өрістердің ешқайсысы барлық жағдайды жеке өзі шеше алмайды.

API күйі өзгермей, оқиғалар тізімінде жаңа жазба пайда болса не істеймін?

Бірнеше тасымалдаушы оқиғасы бір қалыпқа келтірілген күйге сәйкестенсе, бұл күтілетін жағдай болуы мүмкін. Оқиға мәліметтерін салыстырып, қолданбаңыздың жаңа жазбаны тиісті жерде сақтағанын және көрсететінін растаңыз. Жоғалған оқиға мен өзгермеген қорытынды белгіні әртүрлі мәселе ретінде қарастырыңыз.

Дереккөздер