Skip to main content
Ana səhifəBloqBələdçilərAPI vasitəsilə sinxronlaşdırılan ən son daşıyıcı izləmə hadisələrini yoxlamaq üçün 6 yoxlama

API vasitəsilə sinxronlaşdırılan ən son daşıyıcı izləmə hadisələrini yoxlamaq üçün 6 yoxlama

17TRACK

API-nin ən son daşıyıcı izləmə hadisələrini sinxronlaşdırdığını yoxlamaq üçün göndərişin identikliyini, hadisə vaxt möhürlərini, hadisə təfərrüatlarını, çatdırılma marşrutunu, hadisələrin ardıcıllığını və məlumatların yeniliyini müstəqil izləmə görünüşü ilə müqayisə edin. Uğurlu API cavabı və ya webhook təsdiqi bu zəncirin yalnız bir hissəsini təsdiqləyir; bu, öz-özlüyündə tətbiqinizin daşıyıcının ən yeni hadisəsini əldə etdiyini sübut etmir.

Ən son daşıyıcı izləmə hadisələrinin sinxronlaşdırıldığını yoxlamaq üçün 6 yoxlama

Bu təlimat izləmə məlumatlarını sifarişlərin idarə edilməsi sisteminə, müştəriyə açıq səhifəyə, dəstək alətinə və ya xəbərdarlıq iş prosesinə ötürməyə cavabdeh olan tərtibatçılar və əməliyyat qrupları üçündür. Məqsəd hadisənin harada itdiyini və ya dəyişdiyini müəyyən etmək, sonra emalı yenidən sınamaq, uyğunlaşdırmanı düzəltmək və ya daşıyıcıdan yeni məlumat gözləmək barədə qərar verməkdir.

Başlamazdan əvvəl: “ən yeni”nin nə demək olduğunu müəyyənləşdirin

Üç vaxtı ayrı saxlayın: daşıyıcının hadisənin baş verdiyini bildirdiyi vaxt, izləmə provayderinizin onu qəbul etdiyi və ya təqdim etdiyi vaxt, həmçinin tətbiqinizin onu saxladığı vaxt. Bu vaxtlar fərqli ola bilər. Daşıyıcı fiziki hadisədən sonra skanı dərc edə, inteqrasiyanız isə onu daha sonra emal edə bilər. Buna görə də başvermə vaxtına görə ən yeni hadisə mütləq ən son qəbul edilmiş qeyd olmur.

Araşdırmadan əvvəl müqayisə nöqtəsi seçin. İdeal halda eyni göndəriş üçün daşıyıcının izləmə səhifəsindən və ya daşıyıcı tərəfindən təqdim edilən digər səlahiyyətli qeyddən istifadə edin. Bu mümkün deyilsə, tətbiqinizi izləmə provayderinin cari API cavabı ilə müqayisə edin. Bu daha məhdud müqayisə tətbiqinizin provayderlə uyğun olub-olmadığını müəyyən edə bilər; lakin provayderin artıq daşıyıcının bütün skanlarına malik olduğunu sübut edə bilməz. Müqayisəni nə vaxt apardığınızı qeyd edin ki, sonrakı yeniləmə əvvəlki nəticəni uyğunsuz göstərməsin.

1. Hər iki sistemin eyni göndərişə aid olduğunu təsdiqləyin

İzləmə nömrəsi, daşıyıcı və inteqrasiyanızın istifadə etdiyi hesab və ya göndəriş identifikatoru ilə başlayın. Problemlərin aradan qaldırılması üçün yalnız izləmə nömrəsi kifayət etməyə bilər: nömrə səhv daxil edilə, yanlış daşıyıcı ilə əlaqələndirilə və ya sifariş redaktə edildikdən sonra daxili qeyddə yenidən istifadə oluna bilər. Sifariş nömrəsi ilə izləmə nömrəsi də fərqli məqsədlərə xidmət edir. Bir sifarişdə bir neçə bağlama ola bilər, buna görə sifarişin ən son statusunu yoxlamaq köhnəlmiş bağlamanı gizlədə bilər.

  • İzləmə API-sinə göndərilmiş dəqiq izləmə nömrəsini və daşıyıcını tapın.
  • Cavabı hansı daxili göndəriş və ya bağlama qeydinin qəbul etdiyini təsdiqləyin.
  • Qeydiyyatdan sonra göndərişin dəyişdirilib-dəyişdirilmədiyini, bölünüb-bölünmədiyini, ləğv edilmədiyini və ya yenidən əlaqələndirilmədiyini yoxlayın.
  • Mənbə qeydində göstərilən daşıyıcı və nömrəni tətbiqinizdə göstərilənlərlə müqayisə edin.

İdentifikatorlar uyğun gəlmirsə, fərqi sinxronizasiya gecikməsi kimi qiymətləndirməyin. Əvvəlcə əlaqələndirməni düzəldin, sonra hadisə müqayisəsini təkrarlayın. Həssas hesab məlumatlarını bu jurnallara daxil etmədən göndərişi izləmək üçün diaqnostik jurnallarda kifayət qədər identifikator saxlayın.

2. Mənasını itirmədən hadisə vaxtlarını müqayisə edin

Ən yeni ola biləcək hər hadisə üçün daşıyıcının bildirdiyi başvermə vaxtını, təqdim edilibsə göstərilən saat qurşağını və ya ofseti, həmçinin tətbiqinizin qəbul və saxlama vaxtlarını qeyd edin. Müqayisə üçün vaxt möhürlərini ümumi vaxt əsasına çevirin, lakin ilkin dəyəri saxlayın. RFC 3339 açıq ofset məlumatlı internet vaxt möhürü formatını müəyyən edir; öz vaxt sahələrinizi layihələndirərkən faydalı istinaddır. Lakin bu, daşıyıcının və ya provayderin hər hadisə üçün saat qurşağı təqdim etməsinə zəmanət vermir.

Yalnız vaxtı göstərən ekran, ehtimal edilən yerli saat qurşağı və ya ofseti səssizcə silən analizator hadisəni başqa təqvim gününə keçirə və ya yanlış ardıcıllıqda yerləşdirə bilər. Mənbə qeyri-müəyyən yerli vaxt təqdim edirsə, dəqiq UTC anı uydurmaq əvəzinə müqayisəni qeyri-müəyyən kimi işarələyin. Həmçinin hadisənin başvermə vaxtını API cavabının vaxtından ayırın: indi alınan cavab haqlı olaraq daha əvvəl baş vermiş hadisəni ehtiva edə bilər.

Daşıyıcı və ya provayder görünüşünü yoxladığınız vaxtı qeyd edin. Mənbə API sorğunuzdan sonra yeni skan dərc edibsə, iki görünüş arasındakı fərq əvvəlki sorğunun uğursuz olduğunu göstərmir.

3. Yalnız başlıq statusunu deyil, hadisə yükünü yoxlayın

Ən son hadisənin təsvirini, yerini, daşıyıcı statusunu və ya kodunu, həmçinin müvafiq çatdırılma sahələrini yuxarı mənbədəki qeydlə müqayisə edin. “Tranzitdə” kimi normallaşdırılmış status bir neçə fərqli skanı ümumiləşdirə bilər. Tətbiqiniz yalnız xülasəni saxlayırsa, yeni hadisə daxil olsa belə dəyişiklik görünməyə bilər.

Məlumatların emalı qaydalarınız buna icazə verirsə, xam API cavabını və ya saxlanılmış webhook gövdəsini yoxlayın. Sonra hadisəni analiz, sahə uyğunlaşdırması, saxlanma və təqdimat mərhələlərindən keçərək izləyin. Null sahələrin standart dəyərlərlə əvəz edilməsinə, gözlənilməz status kodlarının ümumi kateqoriyaya düşməsinə, mətnin kəsilməsinə və ya istifadəçi interfeysinin yalnız seçilmiş hadisə növlərini göstərməsinə diqqət yetirin. Status etiketi uyğunsuzluğu itkin hadisədən fərqlidir: bu, çatdırılmadan çox transformasiya və ya göstərmə məntiqinə işarə edir.

Yalnız yerin və ya statusun yekun səslənməsinə əsaslanaraq çatdırılma barədə nəticə çıxarmayın. İş prosesinizin əsaslandığı konkret hadisəni və sahələri təsdiqləyin. Əksinə, yüksək səviyyəli statusun dəyişməməsi sinxronizasiyanın dayandığını sübut etmir; yeni qəbul edilmiş skan eyni kateqoriyaya uyğunlaşdırıla bilər. Diaqnostik qeyddə həm yuxarı mənbədəki hadisə, həm də istifadəçilərə göstərilən dəyər saxlanmalıdır.

4. Hadisənin tətbiqinizə necə çatdığını izləyin

Webhook-lardan istifadə edirsinizsə, müvafiq göndəriş və hadisə üçün qəbul jurnalını yoxlayın. Endpoint-in sorğunu qəbul etdiyini, mesajın doğrulamadan keçdiyini və sonrakı emalın tamamlandığını təsdiqləyin. Endpoint-dən alınan HTTP uğur cavabı sonrakı növbə işçisinin hadisəni saxladığını sübut etmir. Emal asinxrondursa, həm daxil olan sorğunu, həm də tapşırığın nəticəsini araşdırın.

API-ni sorğulayırsınızsa, son tamamlanmış sorğunu, həmin sorğudakı göndəriş identifikatorunu, cavabını və inteqrasiyanızın istifadə etdiyi səhifələmə və ya əldəetmə məntiqini yoxlayın. Uğurlu sorğudan sonra verilənlər bazasına yazma uğursuz ola və ya köhnə keş oxuna bilər. Hər izləmə API-sinin eyni müqaviləyə əməl etdiyini fərz etmək əvəzinə, inteqrasiyanız üçün faktiki cavab sahələrini, autentifikasiya tələblərini və çatdırılma davranışını yoxlamaq üçün provayderin müvafiq sənədlərindən istifadə edin. 17TRACK inteqrasiyası üçün müvafiq başlanğıc nöqtələri onun Tracking API səhifəsi və API sənədləridir; istifadə etdiyiniz endpoint və metod üçün sənədləşdirilmiş davranışı təsdiqləyin.

Hadisələrin emalını təkrar icra üçün təhlükəsiz edin. Yenidən cəhd dublikat skanlar yaratmamalı, eyni müştəri bildirişini dəfələrlə göndərməməli və daha köhnə yük ilə daha yeni saxlanılmış vəziyyəti əvəz etməməlidir. Müvafiq dublikat açarı provayderinizin faktiki təqdim etdiyi sahələrdən asılıdır. Seçdiyiniz açarı eyni statusu və ya vaxt möhürünü paylaşan fərqli hadisələr üzərində sınaqdan keçirin; bu hadisələr oxşar göründükləri üçün birləşdirilməməlidir.

5. Ardıcıllığı və vəziyyət keçidi qaydalarını yoxlayın

Qeydə alınmış hadisələri aydın müəyyən edilmiş qaydaya əsasən çeşidləyin, sonra nəticəni yoxlayın. Bir çox tətbiq “baş vermiş ən son hadisə” ilə “qəbul etdiyimiz ən son hadisə”ni fərqləndirməlidir. Gecikmiş əvvəlki skan daha yeni skandan sonra gələ bilər. Verilənlər bazanız sadəcə ən son emal edilmiş mesajı cari göndəriş vəziyyəti edirsə, həmin gecikmiş skan göstərilən statusu geriyə çəkə bilər.

Saxlanılmış tarixçəni yalnız bir status sahəsi ilə deyil, yuxarı mənbənin tarixçəsi ilə müqayisə edin. Yeni qəbul edilmiş qeydin əlavə edilib-edilmədiyini, dublikat kimi silinib-silinmədiyini və ya cari vəziyyəti yeniləməsinə icazə verilib-verilmədiyini soruşun. Müəyyən hadisələrə digərlərindən üstünlük verən qaydaları yoxlayın. Belə qayda məqsədli ola bilər, lakin əsas hadisəni gizlətməməli və tətbiq sadəcə köhnə skanı gec qəbul etdiyi halda daşıyıcının mərhələni geri çevirdiyini göstərməməlidir.

Praktik sınaq üçün birdən çox hadisəsi olan göndəriş götürün və onun mesajlarını istehsal mühitindən kənarda fərqli gəlmə ardıcıllığı ilə yenidən oynadın. Hadisə tarixçəsinin bütöv qaldığını və müştəriyə açıq statusun sənədləşdirilmiş qaydanı izlədiyini təsdiqləyin. Bu, normal ardıcıllıqla aparılan sınağın aşkar edə bilmədiyi ardıcıllıq qüsurlarını üzə çıxarır.

6. Yeniliyi ölçün və istisnaları uzlaşdırın

Nəhayət, hər təbəqənin eyni müşahidə anında nələri bildiyini müqayisə edin: daşıyıcı görünüşü, izləmə provayderinin cavabı, daxil olan webhook və ya sorğu nəticəsi, verilənlər bazası qeydi və müştəriyə açıq nəticə. Gözlənilən hadisənin ilk itdiyi təbəqəni işarələyin. Bu sərhəd “izləmə gecikir” barədə ümumi hesabatdan daha faydalıdır.

Həm daşıyıcının bildirdiyi ən son hadisənin yaşını, həm də inteqrasiyanızın məlumatı sonuncu dəfə uğurla yoxlamasından və ya qəbul etməsindən keçən vaxtı ölçün. Bunlar fərqli suallara cavab verir. İnteqrasiyanız sağlam olsa da bağlamada yeni daşıyıcı skanı olmaya bilər; əksinə, daşıyıcı yeni skan göstərə, son uğurlu sorğunuz isə köhnə ola bilər. Öz əməliyyat tələblərinizi və müşahidə etdiyiniz davranışı əks etdirən xəbərdarlıq hədlərindən istifadə edin. Daşıyıcı və provayder razılaşmalarınız bunu dəstəkləmirsə, müştərilərə sabit yenilənmə intervalı vəd etməyin.

Qeydləri seçilmiş müqayisə mənbəyindən fərqlənən göndərişlər üçün kiçik uzlaşdırma növbəsi yaradın. Buraya identifikatorları, itkin və ya uyğun gəlməyən hadisəni, müvafiq vaxt möhürlərini, ilk uğursuz təbəqəni və növbəti əməli daxil edin. Məsələn, provayder cavabında olub verilənlər bazanızda olmayan hadisə inteqrasiyanın araşdırılmasını tələb edir. Verilənlər bazanızda olub izləmə səhifəsində olmayan hadisə göstərmə və ya keş yoxlamasını tələb edir. Daşıyıcının özündə yeni skan görünmürsə, başqa API sorğusu onu yarada bilməz.

Əməliyyat sınağı sadədir: eyni göndərişi müəyyən edə, onun yuxarı mənbədə məlum olan ən son hadisəsini tapa və mənasını dəyişmədən bu hadisəni istifadəçiyə açıq görünüşə qədər izləyə bilirsinizmi? Əgər yoxdursa, altı yoxlama problemi konkret sərhədə qədər daraldır və komandanıza əsaslandırılmış növbəti addım verir.

FAQ

Uğurlu webhook cavabı ən son hadisənin sinxronlaşdırıldığı deməkdirmi?

Xeyr. Bu, yalnız endpoint-in sorğuya uğurlu cavab qaytardığını göstərir. Doğrulama, növbə emalı, verilənlər bazasında saxlama və göstərmənin də uğurla tamamlandığını təsdiqləyin. Sorğunun hansı hadisəni ehtiva etdiyini müəyyən etmək üçün yükü yoxlayın.

Niyə daşıyıcının səhifəsində API cavabımdan daha yeni skan görünür?

Əvvəlcə eyni bağlamaya baxdığınızı və hər iki müşahidənin müqayisə edilə bilən vaxtlarda aparıldığını təsdiqləyin. Daşıyıcının hadisəni dərc etməsi ilə izləmə provayderinin onu qəbul etməsi və ya təqdim etməsi fərqli vaxtlarda baş verə bilər. Fərq qalırsa, yenilənmə zəmanətini fərz etmək əvəzinə konkret göndərişi araşdırmaq üçün provayderin sənədlərindən və dəstək prosesindən istifadə edin.

Ən son statusu seçmək üçün hadisə vaxt möhüründən, yoxsa sistemimin onu qəbul etdiyi vaxtdan istifadə etməliyəm?

İş prosesinizə uyğun sənədləşdirilmiş qaydadan istifadə edin və hər iki dəyəri saxlayın. Hadisə vaxt möhürü bildirilən fəaliyyətin nə vaxt baş verdiyini, qəbul vaxtı isə sisteminizin bunu nə vaxt öyrəndiyini göstərir. Xüsusilə mənbə vaxtları qeyri-müəyyən olduqda və ya əvvəlki skanlar gec gəldikdə, heç bir sahə təkbaşına bütün halları həll etmir.

API statusu dəyişməz qalır, lakin hadisə siyahısında yeni qeyd varsa, nə etməliyəm?

Bir neçə daşıyıcı hadisəsi vahid normallaşdırılmış statusa uyğunlaşdırılırsa, bu gözlənilən ola bilər. Hadisə təfərrüatlarını müqayisə edin və tətbiqinizin yeni qeydi uyğun yerdə saxladığını və göstərdiyini təsdiqləyin. İtkin hadisə ilə dəyişməz xülasə etiketini fərqli problemlər kimi qiymətləndirin.

Mənbələr