Böyük Britaniya göndərişlərinin izlənməsi üçün API-ni necə seçmək olar: Daşıyıcı əhatə dairəsi və inteqrasiya
Həqiqətən istifadə etdiyiniz daşıyıcıları və çatdırılma xidmətlərini sınaqdan keçirərək, sonra isə izləmə hadisələrinin sistemlərinizə etibarlı şəkildə inteqrasiya edilə bilib-bilmədiyini yoxlayaraq Böyük Britaniya göndərişlərinin izlənməsi üçün API seçin. Uzun daşıyıcı kataloqu kifayət deyil: qısa siyahınızdakı namizədlər Böyük Britaniya daxilindəki çatdırılmalar, sərhədlərarası təhvil-təslimlər, statusların dəqiqliyi, webhook emalı və ümumi əməliyyat xərcləri üzrə real göndəriş sınaqlarından keçməlidir.
E-ticarət əməliyyatları rəhbəri üçün nəticə etibarlı göndəriş görünürlüğüdür. Mühəndislik komandası üçün isə bu, yeniləmələr gecikdikdə, izləmə nömrələri qeyri-müəyyən olduqda və ya çatdırılma tərəfdaşları dəyişdikdə də proqnozlaşdırılan olaraq qalan inteqrasiyadır. Provayderə öhdəlik götürməzdən əvvəl hər iki nəticəni qiymətləndirin.
Provayderin daşıyıcı sayından deyil, göndəriş portfelinizdən başlayın
İzləmə API-si göndəriş məlumatlarını tətbiqdə, sifarişlərin idarə edilməsi sistemində, müştəri dəstəyi alətində və ya digər proqram təminatında istifadə etmək üçün əldə edir. İzləmə inteqrasiyasının avtomatik olaraq etiketlər də aldığını, götürülmələri sifariş etdiyini və ya qaytarmaları idarə etdiyini düşünməyin. Bunlar ayrıca yoxlanmalı tələblərdir.
Provayderləri nəzərdən keçirməzdən əvvəl göndərişlərinizdən reprezentativ nümunəni ixrac edin və onları daşıyıcı, xidmət, mənşə, təyinat və biznes əhəmiyyətinə görə qruplaşdırın. Uğurlu çatdırılmaları və problemli göndərişləri daxil edin. Yalnız sadə daxili çatdırılmalardan ibarət nümunə beynəlxalq təhvil-təslimlər və çatdırılma istisnaları barədə sizə az məlumat verəcək.
Aşağıdakı sahələri əhatə edən tələblər cədvəli hazırlayın:
- Daşıyıcı və xidmət: Yalnız daşıyıcının brend adını deyil, biznesinizin istifadə etdiyi dəqiq xidməti qeyd edin.
- Marşrut: Böyük Britaniya daxili, Böyük Britaniyaya daxil olan və Böyük Britaniyadan çıxan göndərişləri ayırın.
- Göndəriş identifikatoru: Bağlama nömrəsi, yük istinad nömrəsi, sifariş istinad nömrəsi və ya bir neçə identifikator qəbul etdiyinizi qeyd edin.
- Tələb olunan hadisələr: Müştəri mesajlarını və ya əməliyyat tədbirlərini işə salan mərhələləri müəyyən edin.
- Biznes sahibi: Dayanmış göndərişlərin, uğursuz çatdırılmaların və səhv yeniləmələrin araşdırılmasına görə məsul şəxs təyin edin.
Mütləq əhatə siyahınıza müqavilələrinizdən asılı olaraq Royal Mail, Parcelforce Worldwide, Evri və ya DPD daxil ola bilər. Bunlar araşdırılmalı nümunələrdir; hər hansı konkret API-nin həmin daşıyıcıların təklif etdiyi bütün xidmətləri dəstəklədiyi barədə bəyanat deyil.
Daşıyıcı əhatəsi praktikada nə deməlidir
“Bu daşıyıcını dəstəkləyir” qiymətləndirmənin yalnız başlanğıcıdır. Faydalı əhatə dedikdə API-nin istifadə etdiyiniz xidmətlər və marşrutlar üçün iş axınlarınızın ehtiyac duyduğu hadisələri əldə etməsi nəzərdə tutulur. Daşıyıcı siyahısını istehsala hazır olduğuna sübut kimi deyil, sınaq keçirmək üçün səbəb kimi qəbul edin.
Xidmət və marşrut səviyyəsində əhatəni yoxlayın
Provayderdən dəqiq daşıyıcı inteqrasiyasını, tələb olunan hesab məlumatlarını və əlavə göndəriş sahələrini təsdiqləməsini istəyin. İzləmənin müqavilə bağladığınız xidmətlər üçün işləyib-işləmədiyini və poçt indeksi və ya təyinat məlumatının tələb olunub-olunmadığını müəyyənləşdirin. Bir xidmətdə uğurlu sınağın digər xidmətə dəstəyi sübut etdiyini düşünməyin.
Hadisələrin tamlığını yoxlamaq üçün öz göndərişlərinizdən istifadə edin. Hər yoxlamanın vaxtını qeyd edərək API cavabını daşıyıcının izləmə səhifəsi ilə müqayisə edin. Məqsəd mütləq eyni ifadələrin olması deyil; əməliyyat baxımından əhəmiyyətli məlumatın inteqrasiyadan sonra qorunub-qorunmamasıdır.
Beynəlxalq təhvil-təslimləri ayrıca sınaqdan keçirin
Sərhədlərarası göndərişlərdə birdən çox çatdırılma tərəfdaşı iştirak edə bilər. Məlumat mövcud olduqda inteqrasiyanın növbəti daşıyıcını və ya izləmə nömrəsini göstərib-göstərmədiyini yoxlayın. Həmçinin tətbiqinizin müştərilərə təkrar bildirişlər göndərmədən bir göndərişlə bir neçə izləmə nömrəsini əlaqələndirə bildiyini yoxlayın.
API-nin əsas çatdırılma şəbəkəsinin təqdim etmədiyi hadisələri göstərə biləcəyini düşünməyin. Məsuliyyət təyin etməzdən əvvəl inteqrasiya problemini, daşıyıcının məlumat yayımlamasındakı gecikməni və göndəriş marşrutundakı real boşluğu bir-birindən ayırın.
Daşıyıcının müəyyənləşdirilməsini və qeyri-müəyyən nömrələri yoxlayın
Provayder avtomatik daşıyıcı müəyyənləşdirməsi təklif edirsə, qeyri-müəyyən və səhv daxil edilmiş nömrələri sınaqdan keçirin. Açıq daşıyıcı identifikatoru təqdim edə bilib-bilmədiyinizi və sistemin qeyri-müəyyən uyğunluğu necə idarə etdiyini soruşun. İnandırıcı görünən hadisələr yaradan səhv uyğunluq aydın doğrulama xətasından daha çox problem yarada bilər.
Daha yüksək riskli iş axınları üçün icra sisteminizin təqdim etdiyi daşıyıcını izləmə nömrəsi ilə birlikdə saxlayın. Avtomatik müəyyənləşdirməni göndəriş metadatasını qorumağın əvəzi deyil, yoxlanmalı funksiya kimi qəbul edin.
Birbaşa daşıyıcı inteqrasiyaları ilə çoxdaşıyıcılı API arasında seçim edin
Birbaşa daşıyıcı inteqrasiyası sabit daşıyıcı portfelinə və konkret daşıyıcının məlumatlarına sıx bağlı tələblərə malik biznes üçün uyğun ola bilər. Bununla belə, hər bir ayrıca bağlantının hazırlanması və saxlanmasına görə məsuliyyət yenə də komandanızın üzərində qalır.
Çoxdaşıyıcılı API sistemlərinizin bir neçə çatdırılma şəbəkəsi üzrə ümumi inteqrasiyaya ehtiyacı olduqda qiymətləndirilməyə dəyər. Lakin ümumi interfeys avtomatik olaraq bütün daşıyıcılarda eyni məlumat dərinliyi, yenilənmə tezliyi və ya hadisə keyfiyyəti demək deyil. Bu fərqlər yenə də sınaqdan keçirilməlidir.
17TRACK bu qiymətləndirmə üçün Tracking API təklifi vasitəsilə əhəmiyyətlidir. İnteqrasiya tələblərini yoxlamağa başlamaq üçün onun rəsmi API sənədlərindən istifadə edin, sonra isə daşıyıcı və xidmət siyahınızı birbaşa təsdiqləyin. Bu, eyni qəbul prosesində qiymətləndiriləcək namizəddir; əhatə və etibarlılıq sınaqlarını keçməmək üçün səbəb deyil.
Qərar qaydası: Ümumi inteqrasiya tələb etdiyiniz hadisələri itirmədən texniki xidməti əhəmiyyətli dərəcədə azaldırsa, çoxdaşıyıcılı yanaşmaya üstünlük verin. Daşıyıcıya xas tələb həlledicidirsə və komandanız onu dəstəkləyə bilirsə, birbaşa inteqrasiyaya üstünlük verin. Hibrid yanaşma uyğun ola bilər, lakin hər ikisi eyni göndəriş barədə məlumat verdikdə hansı mənbənin prioritet olduğunu müəyyən edin.
Müştəri iş axınlarını yaratmazdan əvvəl hadisə modelini qiymətləndirin
İzləmə məlumatları yalnız proqram təminatınız onu düzgün şərh etdikdə faydalı olur. Normal çatdırılmaları, istisnaları, qaytarmaları və hələ heç bir hadisəsi olmayan göndərişləri əhatə edən nümunə cavabları istəyin. Həm ümumi status kateqoriyalarını, həm də mövcud olan orijinal daşıyıcı təsvirlərini nəzərdən keçirin.
Ümumi “istisna” statusu panel üçün uyğun ola bilər, lakin dəstək komandanız ünvan problemini uğursuz çatdırılma cəhdindən ayırmalı ola bilər. Əksinə, əlavə uyğunlaşdırma olmadan müştəri kommunikasiyalarını işə salmaq üçün xam daşıyıcı mesajı həddən artıq qeyri-sabit ola bilər.
- Zaman nişanları: Sahənin hadisə vaxtını, əldə etmə vaxtını və ya bildiriş vaxtını göstərdiyini, həmçinin saat qurşaqlarının necə ifadə olunduğunu müəyyən edin.
- Hadisə identikliyi: Hadisələrin sabit identifikatorlara malik olub-olmadığını və ya tətbiqinizin təkrarlamaların qarşısını almaq üçün açar yaratmalı olduğunu yoxlayın.
- Status dəyişiklikləri: Düzəlişlərin, köhnə hadisələrin və görünən çatdırılmadan sonrakı yeniləmələrin necə göstərildiyini müəyyənləşdirin.
- Çatışmayan məlumat: Naməlum məkanların, olmayan zaman nişanlarının və mövcud olmayan çatdırılma təxminlərinin necə göstərildiyini təsdiqləyin.
- Xam təfərrüat: Dəstək və araşdırma üçün orijinal hadisə təsvirinin saxlanmasının zəruri olub-olmadığına qərar verin.
“Hələ izləmə hadisəsi yoxdur” statusunu “itib” statusundan ayrı saxlayın. Eyni şəkildə, çatdırılma təxminini zəmanətli çatdırılma tarixinə çevirməyin. Tətbiqiniz mənbə məlumatlarının dəstəkləmədiyi əminlik yaratmaq əvəzinə qeyri-müəyyənliyi qorumalıdır.
Yalnız uğurlu sorğular üçün deyil, webhook xətaları üçün də dizayn edin
Qısa siyahıya alınmış API webhook-lar təklif edirsə, onların necə autentifikasiya edildiyini, yenidən cəhd göstərdiyini və təsdiqləndiyini araşdırın. Polling istifadə edirsə, sorğu limitlərini və əməliyyat ehtiyaclarınıza uyğun əldəetmə cədvəlini müəyyən edin. Heç bir yanaşma monitorinq və bərpa ehtiyacını aradan qaldırmır.
Webhook əsaslı inteqrasiya üçün möhkəm dizayn sorğunu yoxlamaq, payload-u davamlı şəkildə saxlamaq və ya növbəyə yerləşdirmək, sonra isə provayderin tələblərinə uyğun olaraq təsdiqləməkdir. Müştəri bildirişlərini ayrıca emal edin ki, yavaş mesajlaşma xidməti məlumatların qəbulunu bloklamasın.
Tətbiqdən əvvəl bu suallara cavab verin:
- Endpoint-iniz sorğunun provayderdən gəldiyini necə yoxlayır?
- Endpoint-iniz vaxtı keçdikdə və ya xəta qaytardıqda nə baş verir?
- Çatdırılmalar təkrarlana və ya ardıcıllıqdan kənar gələ bilərmi?
- Buraxılmış yeniləmələr əldə edilə və ya təkrar oynadıla bilərmi?
- Xidmətə fasilə vermədən hesab məlumatları necə yenilənir?
- Bərpa zamanı sürət limitlərinə çatıldıqda nə baş verir?
Emalı idempotent şəkildə dizayn edin: eyni yeniləmənin yenidən qəbul edilməsi başqa müştəri mesajı və ya təkrar dəstək tapşırığı yaratmamalıdır. Göndəriş statusunu bildiriş tarixçəsindən ayrı saxlayın və müştəriyə yönəlmiş hər tədbirin niyə işə salındığını qeyd edin.
Qeydiyyat xətaları üçün də əvvəlcədən plan qurun. İzləmə nömrəsinin əlavə edilməsi uğursuz olarsa, aydın xəta saxlayın və yalnız uyğun hallarda yenidən cəhd edin. Yanlış identifikatoru təkrar-təkrar sınaqdan keçirmək bərpa strategiyası deyil.
Aydın keçid meyarları ilə konsepsiyanın sübutunu aparın
Faydalı konsepsiya sübutu inteqrasiyanı cilalanmış nümayişlə deyil, tələblərinizlə müqayisə edir. Hər mühüm daşıyıcı-xidmət kombinasiyasından göndərişləri daxil edin və əlverişsiz şərtləri məqsədli şəkildə sınaqdan keçirin.
| Sınaq nümunəsi | Nə yoxlanılmalıdır | Qəbul prinsipi |
|---|---|---|
| Böyük Britaniya daxili çatdırılması | Hadisələrin tamlığı və yekun status | Tələb olunan mərhələlər düzgün sifarişə çatır. |
| Sərhədlərarası təhvil-təslim | Daşıyıcı dəyişiklikləri və əlavə identifikatorlar | Mövcud təhvil-təslim məlumatı göndərişlə əlaqəli qalır. |
| Çatdırılma istisnası | Statusun mənası və orijinal təfərrüat | Müvafiq komanda növbəti tədbiri müəyyən edə bilir. |
| Təkrar və ya köhnə yeniləmə | Təkrarlamaların qarşısının alınması və hadisələrin ardıcıllığı | Təkrar mesaj və ya səhv status geriləməsi baş vermir. |
| Endpoint-in müvəqqəti əlçatmazlığı | Yenidən cəhdlər və uzlaşdırma | Buraxılmış məlumat sınaqdan keçirilmiş proseslə bərpa edilə bilir. |
Sınaqdan əvvəl öz hədlərinizi müəyyən edin. Hadisələrin tamlığını müəyyən edilmiş mərhələlərə əsasən ölçün və daşıyıcıda hadisəni müşahidə etməklə onu API vasitəsilə qəbul etmə arasındakı gecikməni qeyd edin. Müşahidə üsullarını ardıcıl saxlayın; yalnız hadisənin zaman nişanı həmin hadisənin nə vaxt əlçatan olduğunu müəyyən etmir.
Kritik xətaları üstünlüklərdən ayırın. Tələb olunan əhatənin olmaması və ya işləməyən bərpa prosesi tətbiqə buraxılışı dayandırmalıdır. Daha az rahat panel isə bunu etməyə bilər. Ümumi yüksək balın məcburi tələbdəki uğursuzluğu gizlətməsinə imkan verməyin.
Ümumi xərci, məlumatların işlənməsini və dəstəyi müqayisə edin
Göndəriş həcminizə və istifadə modelinizə əsaslanan qiymət təklifi istəyin. Nəyin hesablandığını dəqiqləşdirin: qeydiyyata alınmış izləmə nömrələri, sorğular, aktiv göndərişlər, yeniləmələr və ya başqa vahid. Təkrar qeydiyyatların, tarixi axtarışların, uğursuz təqdimlərin və limitdən artıq istifadənin necə hesablandığını soruşun. İki planın izlənən göndəriş anlayışını eyni cür müəyyən etdiyini düşünməyin.
Texniki xidmət, monitorinq, istisnaların idarə edilməsi və miqrasiya işlərini xərc modelinizə daxil edin. Aşağı abunə haqqı mütləq aşağı əməliyyat xərci demək deyil; yüksək ödəniş də daha yaxşı izləmə keyfiyyətinə sübut deyil.
Məlumatların işlənməsi baxımından hansı sahələrin sistemlərinizi tərk edəcəyini və bunun səbəbini sənədləşdirin. İnteqrasiyanın ehtiyac duymadığı müştəri məlumatlarını göndərməkdən çəkinin. Təhlükəsizlik və məxfilik komandalarınızla giriş nəzarətlərini, saxlanmanı, silinməni, hostinq razılaşmalarını və müqavilə öhdəliklərini nəzərdən keçirin. API-nin Böyük Britaniya göndərişlərini izləməsinə əsasən Böyük Britaniyada məlumat saxlanmasını və ya tənzimləyici uyğunluğu fərz etməyin.
Dəstək razılaşmaları uğursuzluğun biznesə təsirinə uyğun olmalıdır. Daşıyıcıya xas problemi necə eskalasiya etməyi, dəstəyin hansı diaqnostik məlumatlara ehtiyac duyduğunu və hansı xidmət öhdəliklərinin müqavilə ilə təsbit edildiyini soruşun. Ümumi platforma əlçatanlığı öhdəliyi özlüyündə hər daşıyıcıdan vaxtında hadisələrin alınmasına zəmanət vermir.
Tətbiqi geri qaytarıla bilən edin
Nəzarət olunan göndəriş qrupu ilə başlayın və müştəriyə yönəlmiş avtomatlaşdırmanı aktivləşdirməzdən əvvəl nəticələri müqayisə edin. Praktik baxımdan mümkündürsə, yeni inteqrasiyanı müşahidə rejimində işlədin ki, komandanız mesaj göndərmədən status uyğunlaşdırmalarını yoxlaya bilsin.
Hesab məlumatları, daşıyıcı konfiqurasiyası, xəbərdarlıqlar və insidentlərə cavab üçün məsul şəxs təyin edin. Xətaları araşdırmaq və gələcək miqrasiyanı dəstəkləmək üçün kifayət qədər göndəriş identifikatorlarını və emal tarixçəsini saxlayın. Portativliyi fərz etmək əvəzinə komandanızın ehtiyac duyduğu qeydləri ixrac edə bildiyini təsdiqləyin.
Düzgün Böyük Britaniya göndəriş izləmə API-si məcburi marşrut və hadisə sınaqlarınızdan keçən, inteqrasiya arxitekturanıza uyğun gələn və məqbul əməliyyat şərtlərinə malik olan API-dir. Bu qərarı yalnız daşıyıcı saylarına və ya funksiya adlarına deyil, göndəriş sübutlarına və bərpa sınaqlarına əsasən verin.
FAQ
Böyük Britaniya biznesinin Böyük Britaniyada hostinq olunan izləmə API-sinə ehtiyacı varmı?
Avtomatik olaraq yox. Daşıyıcı əhatəsi, hostinq məkanı və müqavilə üzrə məlumat emalı razılaşmaları fərqli məsələlərdir. Əvvəlcə biznes və məxfilik tələblərinizi müəyyən edin, sonra provayderin razılaşmalarının bunlara cavab verib-vermədiyini yoxlayın. Böyük Britaniya bağlamalarının izlənməsi məlumatların harada emal edildiyini göstərmir.
Göndərişi yalnız sifariş nömrəsindən istifadə etməklə izləyə bilərəmmi?
Bunu fərz etməyin. Daxili sifariş nömrəsi daşıyıcı və ya API tərəfindən tanınmaya bilər. Sisteminiz bir sifarişlə onun göndəriş identifikatorları arasındakı əlaqəni, o cümlədən bir neçə bağlamanı və ya əvəzləyici göndərişləri saxlamalıdır. İnteqrasiyanın qəbul etdiyi identifikatorları təsdiqləyin.
Webhook-lar həmişə polling-dən daha yaxşıdır?
Xeyr. Webhook-lar təkrar əldəetmə sorğularını azalda bilər, lakin etibarlı qəbul edən endpoint və təkrarların idarə edilməsini tələb edir. Sorğu limitləri və məqbul gecikmələr nəzərə alınmaqla polling bəzi iş axınlarına uyğun ola bilər. Hər iki metodu mahiyyət etibarilə kifayət hesab etmək əvəzinə, sənədləşdirilmiş davranış və sınaqdan keçirilmiş bərpa əsasında seçim edin.
Daşıyıcının səhifəsi ilə API arasında uyğunsuzluq olduqda nə etməliyəm?
İzləmə nömrəsini, daşıyıcını, xam cavabları və müşahidə vaxtlarını qeyd edin. Fərqin ifadələrlə, çatışmayan hadisələrlə və ya həqiqətən fərqli göndəriş statusu ilə bağlı olub-olmadığını yoxlayın. Müəyyən edilmiş eskalasiya və uzlaşdırma prosesini tətbiq edin; təkrar bildirişləri və ziddiyyətli status uyğunlaşdırmalarını nəzərə almadan mənbələri səssizcə dəyişməyin.
Mənbələr
Aşağıdakı rəsmi istinadlar 17TRACK-i namizəd kimi qiymətləndirmək üçün başlanğıc nöqtələridir. Daşıyıcı-xidmət əlçatanlığı, qiymətlər, təhlükəsizlik razılaşmaları və müqavilə öhdəlikləri təklif olunan tətbiq üçün təsdiqlənməlidir. Bu təlimatdakı sınaq və seçim meyarları redaksiya tövsiyələridir; hər bir provayderin təsvir olunan imkanları təklif etdiyi barədə iddia deyil.
- 17TRACK Tracking API — bu təlimatda müzakirə olunan API təklifi üçün rəsmi məhsul istinadı.
- 17TRACK API documentation — tətbiqdən əvvəl inteqrasiya tələblərini yoxlamaq üçün rəsmi texniki istinad.


