İstehsalata keçməzdən əvvəl izləmə API provayderinə veriləcək 15 sual
İzləmə API-sini istehsala təqdim etməzdən əvvəl onun real daşıyıcılarınızı və göndəriş növlərinizi necə idarə etdiyini, hadisələrinin nə məna verdiyini, yeniləmələrin necə çatdırıldığını və məlumatlar və ya inteqrasiya uğursuz olduqda nə baş verdiyini soruşun. Aşağıdakı 15 sual mühəndislik və əməliyyat komandalarına müştərilər, dəstək agentləri və ya avtomatlaşdırılmış iş axınları bu məlumatlardan asılı olmamışdan əvvəl cavabları praktiki şəkildə yoxlamaq imkanı verir.

Uğurlu demo istehsal testi deyil. Gecikmiş, geri qaytarılmış və çətin müəyyən edilən bağlamalar daxil olmaqla, göndərişlərinizi təmsil edən nümunədən istifadə edin. Hər cavab üçün sənədləşmə, nümunə payload və ya test nəticəsi tələb edin. Həll olunmamış hər bir məsələni işə salındıqdan sonra həll olunacağını düşünmək əvəzinə, məsul şəxs və qərar tarixi ilə qeyd edin.
Göndəriş uyğunluğu və məlumatların mənası ilə başlayın
1. Faktiki göndərişlərimizin hansını izləyə bilərsiniz və əhatə dairəsi nə deməkdir?
Təminatçıya daşıyıcılarınızın, xidmətlərinizin, göndərmə və təyinat cütlüklərinizin, həmçinin izləmə nömrəsi formatlarınızın nümunəsini təqdim edin. Hansı göndərişləri qəbul edə bildiyini, hansı daşıyıcıları avtomatik müəyyən edə bildiyini və harada daşıyıcı kodunu sizin təqdim etməli olduğunuzu soruşun. Daşıyıcının siyahıda olması hər bir xidmətin, ötürmənin və ya göndəriş növünün tətbiqinizə lazım olan hadisələri yaradacağını göstərmir.
Yüksək həcmli marşrutlardan və əməliyyat baxımından xüsusi hallardan real nümunələri test edin. Biznesinizdə belə hal baş verirsə, tranzit zamanı daşıyıcısını dəyişən göndərişi də daxil edin. API-nin göndərişi rədd edib-etmədiyini, hadisələri tapmadan qəbul edib-etmədiyini və ya məhdud detallı hadisələr qaytarıb-qaytarmadığını qeyd edin. Sifarişlərin idarə edilməsi sistemində bu nəticələrin hər biri fərqli şəkildə işlənməlidir.
2. Göndərişi qeydiyyata almaq üçün nə tələb olunur və təkrar qeydiyyatların qarşısını necə alırsınız?
Tələb olunan identifikatorları, daşıyıcı seçimi qaydalarını, qeydiyyat vaxtını və etibarsız və ya hələ aktiv olmayan izləmə nömrəsinə verilən cavabı dəqiqləşdirin. İstifadə ssenariniz üçün yalnız izləmə nömrəsinin kifayət edib-etmədiyini və ya əlavə məlumat lazım olduğunu soruşun. Eyni göndəriş eyni sistem və ya ayrı xidmətlər tərəfindən iki dəfə təqdim edilərsə nə baş verdiyini təsdiqləyin.
Aydın məsuliyyət bölgüsü ilə vahid qeydiyyat axını yaradın: göndərişləri hansı sistem təqdim edir, təminatçının identifikatorunu hansı sistem saxlayır və qeyri-müəyyən təqdimatı hansı sistem yenidən sınaqdan keçirir. Təminatçı sorğunu emal etdikdən sonra sorğu vaxt aşımına uğrayarsa, kor-koranə təkrar cəhd ikinci qeyd və ya aşağı axın bildirişlərinin təkrarlanmasına səssizcə səbəb olmamalıdır.
3. Statuslarınız nə deməkdir və əsas daşıyıcı hadisələrini yoxlaya bilərikmi?
Status lüğəti və təmsilçi xam hadisələr tələb edin. “Tranzitdə”, “çatdırılma üçün çıxıb”, “istisna”, “çatdırıldı” və “geri qaytarıldı” kimi terminlər faydalı xülasələrdir, lakin biznes qaydalarınız daha ətraflı məlumat tələb edə bilər. Təminatçının standartlaşdırılmış statuslarla yanaşı daşıyıcının orijinal təsvirlərini təqdim edib-etmədiyini və dəqiq uyğunlaşdırıla bilməyən hadisəni necə idarə etdiyini müəyyənləşdirin.
İşə salınmazdan əvvəl öz daxili status modeliniz barədə razılığa gəlin. Xüsusilə hansı hadisənin göndərişi bağlayacağını, çatdırılma mesajını işə salacağını və ya istisna iş axınını başladacağını müəyyən edin. Əsas məlumatlar bu şərhi dəstəkləmədikcə, geniş status etiketini konkret fiziki hadisənin sübutu kimi qəbul etməyin.
4. Hansı vaxt möhürləri və məkanlar təqdim olunur və onları necə şərh etməliyik?
Hər hadisə üçün daşıyıcının hadisənin baş verdiyini bildirdiyi vaxtı, təminatçının onu qəbul etdiyi və ya yayımladığı vaxtdan fərqləndirin. Saat qurşaqları, çatışmayan ofsetlər, məkan dəqiqliyi və daha sonrakı hadisələrdən sonra gələn yeniləmələr barədə soruşun. Bu yaxınlarda qəbul edilmiş hadisə daha əvvəlki skanı təsvir edə bilər; yalnız qəbul vaxtına görə sıralama yanıltıcı xronologiya yarada bilər.
Payload-u verilənlər bazası sxeminiz və müştəriyə göstərilən ekranla yoxlayın. Yerli saat qurşağı qeyri-müəyyən olduqda hadisənin necə göstəriləcəyinə qərar verin və mənbə dəqiq çatdırılma vaxtı və ya məkan təqdim etmirsə, bunları dəqiq şəkildə göstərməyin.
5. İstisnalar, geri qaytarmalar və çatdırılma sübutu necə təqdim olunur?
Uğursuz çatdırılma cəhdləri, gömrükdə saxlanmalar, ünvan problemləri, göndəriciyə qaytarılma hərəkətləri və çatdırılmış göndəriş nümunələri tələb edin. Hansı detalların standartlaşdırıldığını, hansılarının daşıyıcıya xas qaldığını və çatdırılmanın təsdiqinin sizin üçün vacib hallarda dəstəkləyici sübutlar ehtiva edib-etmədiyini soruşun. Çatdırıldı statusunun alıcının adını, imzanı, fotoşəkli və ya başqa sübutu ehtiva etdiyini düşünməyin.
Hər istisnanı fəaliyyətə cavabdeh şəxslə əlaqələndirin. Bəzi hadisələr dəstək tərəfindən araşdırılma tələb edir; digərləri isə əlavə məlumat gələnədək müştəriyə mesaj göndərilməsini tələb etmir. Mübahisə iş axını üçün çatdırılma sübutu zəruridirsə, onun mövcudluğunu və formatını izləmə əhatəsinin dolayı hissəsi kimi deyil, ayrıca qəbul meyarı kimi müəyyən edin.
Yeniləmələrin sistemlərinizə necə çatdığını test edin
6. Yeniləmələri webhook, sorğulama və ya hər ikisi ilə çatdırırsınız və hər birindən nə vaxt istifadə etməliyik?
Sənədləşdirilmiş çatdırılma modeli, payload nümunələri, abunəlik quruluşu və buraxılmış yeniləmələrin bərpası ilə bağlı təlimatları soruşun. Webhook təklif edilirsə, onun dəyişmiş göndərişi elan etdiyini, tam görüntü təqdim etdiyini və ya ayrıca hadisə daşıdığını müəyyən edin. Sorğulama tələb olunursa və ya ehtiyat variant kimi istifadə edilirsə, uyğun sorğu modelini və dəyişmiş qeydlərin necə müəyyənləşdiriləcəyini dəqiqləşdirin.
Modeli iş axınına əsasən seçin. Müştəriyə göstərilən xronologiya istisnalar növbəsindən fərqli yenilənmə gecikməsinə dözə bilər. İnteqrasiya webhook-lardan istifadə etdiyi üçün arxitekturanız dərhal xəbərdarlıqlar vəd etməməlidir: əvvəlcə daşıyıcı hadisəni əlçatan etməli, sonra hər bir sistem onu emal etməlidir.
7. Bildirişlər təkrarlandıqda, gecikdikdə və ya ardıcıllıqdan kənar gəldikdə nə baş verir?
Təminatçının uğursuz çatdırılmaları təkrar edib-etmədiyini, bunu nə qədər müddət etdiyini və endpoint-dən hansı cavabı gözlədiyini soruşun. Mövcuddursa, sabit hadisə və ya göndəriş identifikatoru tələb edin. Sonra eyni bildirişi iki dəfə test edin, daha köhnə hadisəni yenisindən sonra göndərin və endpoint-dən müvəqqəti olaraq xəta qaytarın.
Qəbul edən sistem yalnız təhlükəsiz qəbul etdiyi məlumatı təsdiqləməli, müştəri mesajlarını təkrarlamadan yenidən cəhdləri emal etməli və hadisələr ardıcıllıqdan kənar gəldikdə düzgün xronologiyanı bərpa etməlidir. Təklif olunan dizayn hər bildirişin dəqiq bir dəfə çatdırılmasından asılıdırsa, buraxılışdan əvvəl bu fərziyyəni yenidən yoxlayın.
8. Məlumatların yeniliyini necə ölçəcəyik və buna nə təsir edir?
Təminatçının hər mərhələdə nəyi ölçə bildiyini soruşun: daşıyıcının hadisə vaxtı, təminatçının qəbul vaxtı və sisteminizə çatdırılma vaxtı. Bu ölçmələri onun verdiyi hər hansı öhdəlikdən fərqləndirin. Fiziki hərəkətlə tətbiqinizdəki yeniləmə arasındakı uzun fasilə yuxarı axından, təminatçının emalından və ya öz növbənizdən qaynaqlana bilər.
Pilot müddətində təmsilçi göndərişlər üçün bu fasilələri ölçün və kənaraçıxan nəticələri araşdırın. Xəbərdarlıq hədlərini iş axınınızın həqiqətən tələb etdiyi səviyyəyə uyğun müəyyən edin. Gecikmiş skan zərərli müştəri mesajına və ya qaçırılmış eskalasiyaya səbəb ola bilərsə, köhnə məlumat etiketi və ya əl ilə araşdırma kimi ehtiyat tədbiri müəyyən edin.
9. API məlumatları və webhook sorğuları necə qorunur?
Autentifikasiya və məlumatların idarə edilməsi sənədlərini tələb edin. Məlumatların necə verildiyini, əhatə dairəsinin necə müəyyənləşdirildiyini, dəyişdirildiyini və ləğv edildiyini; test və istehsal məlumatlarının ayrı olub-olmadığını; webhook qəbul edənin sorğunun həqiqi olduğunu necə yoxlaya biləcəyini təsdiqləyin. Təkrar göndərilən webhook sorğularına qarşı hansı müdafiələrin olduğunu da soruşun.
Təhlükəsizlik komandanız yalnız təminatçının funksiya siyahısını deyil, təklif olunan tətbiqi də nəzərdən keçirsin. Məxfi məlumatları müştəri tərəfi kodundan və jurnallardan uzaq saxlayın, istehsal məlumatlarına çıxışı məhdudlaşdırın və məlumatların dəyişdirilməsi prosesini məşq edin. Tətbiqiniz daxil olan bildirişi sənədləşdirilmiş mexanizmlə yoxlaya bilmirsə, webhook əsaslı iş axını üçün bu, buraxılışa maneədir.
10. Hansı göndəriş və müştəri məlumatlarını saxlayırsınız və onlar hara gedir?
İnteqrasiyanızın göndərəcəyi hər bir sahəni, o cümlədən izləmə nömrələrini, sifariş istinadlarını, ünvanları, əlaqə məlumatlarını və xüsusi metadata-nı sadalayın. Hansı sahələrin tələb olunduğunu, məlumatların və jurnalların nə qədər saxlanıldığını, silinmə sorğularının necə icra edildiyini və təşkilatınızın tələbləri üçün hansı regionların və ya subprosessorların əhəmiyyət daşıdığını soruşun. Yoxlamanız tələb etdikdə müqavilə və ya təhlükəsizlik sənədlərini əldə edin.
Ötürdüyünüz məlumatları minimuma endirin. Bütün sifariş obyektini ötürmək rahat olduğu üçün izləmə inteqrasiyası müştəri məlumatlarını qəbul etməməlidir. Məxfilik, hüquq və təhlükəsizlik komandalarınız təminatçının sənədləşdirilmiş məlumat emalının fəaliyyət göstərdiyiniz bazarlara uyğun olub-olmadığına qərar verməlidir.
Uğursuzluq və əməliyyat dəyişikliklərinə hazırlaşın
11. Sorğu limitləri nədir və müştərilər xətalara necə cavab verməlidir?
Endpoint, məlumat və mühit üzrə limitləri, həmçinin paralellik qaydalarını və tövsiyə olunan yenidən cəhd davranışını soruşun. Etibarsız sorğunu müvəqqəti xidmət problemindən və sorğu limitinə çatmış sorğudan fərqləndirin. HTTP API-ləri üçün status kodlarının mənası vacibdir: RFC 6585 həddən artıq sorğular üçün 429 kodunu müəyyən edir, RFC 9110 isə server xətaları daxil olmaqla HTTP semantikasını təsvir edir.
Adi günlər və sıçrayışlar üçün gözlənilən trafiki hesablayın, sonra geri çəkilən, işi növbəyə qoyan və davamlı uğursuzluqlar barədə xəbərdarlıq edən müştərini test edin. Qeyri-müəyyən yazma əməliyyatının təhlükəsiz şəkildə təkrar edilə biləcəyini təsdiqləyin. Kəsinti zamanı trafiki dəfələrlə artıran yenidən cəhd siyasəti bərpanı çətinləşdirə bilər.
12. Sxem, status və daşıyıcı inteqrasiyası dəyişiklikləri necə bildirilir?
API versiyalaşdırması, köhnəlmə bildirişləri, dəyişiklik jurnalları və hadisə sahələrinin versiya dəyişikliyi olmadan əlavə edilə bilib-bilmədiyini soruşun. Daşıyıcı tərəfindən təqdim edilən təsvirlər və izləmə davranışı da dəyişə bilər. Bütün API-yə deyil, yalnız bir daşıyıcıya və ya marşruta təsir edən dəyişikliyin necə bildirildiyini müəyyən edin.
İstəyə bağlı sahələr və naməlum status dəyərləri üçün tolerant parser-lər yazın, lakin tanımadığınız dəyəri səssizcə “çatdırıldı” və ya “uğursuz oldu” kimi çevirməyin. Dəyişmiş uyğunlaşdırmanı diaqnoz etmək üçün kifayət qədər mənbə detalı saxlayın. Təminatçı bildirişlərini nəzərdən keçirəcək və dəyişiklik müştərilərə çatmazdan əvvəl inteqrasiya testlərinizi yeniləyəcək məsul şəxs təyin edin.
13. İstehsaldan əvvəl nəyi test edə bilərik və test mühiti canlı davranışa nə qədər yaxındır?
Sənədlərə, təklif olunursa test mühitinə, nümunə cavablara və xəta yollarını yoxlamaq üsuluna çıxış tələb edin. Hansı ssenarilərin simulyasiya edildiyini, hansılarının isə canlı göndəriş tələb etdiyini soruşun. Sandbox kodunuzun payload-u idarə etdiyini sübut edə bilər, lakin daşıyıcı hadisələrinin tamlığı, yeniləmə vaxtı və regional uyğunluq barədə az məlumat verə bilər.
İki növ test aparın: parser-lər, yenidən cəhdlər və təhlükəsizlik üçün deterministik inteqrasiya testləri; əməliyyat davranışı üçün isə məhdud canlı göndəriş pilotu. Təkrar təqdimetmələri, təminatçının vaxt aşımını, gecikmiş skanı, geri qaytarmanı və naməlum statusu daxil edin. Həm mühəndislik, həm də istisnalarla işləyəcək komanda nəticələri təsdiqləməlidir.
14. İzləmə yenilənməyi dayandırdıqda hansı dəstək və insident öhdəlikləri tətbiq olunur?
Hesabınız üçün hansı dəstək kanallarının mövcud olduğunu, insidentlərin necə bildirildiyini və API-yə və ya bildirişlərin çatdırılmasına hansı müqavilə xidmət öhdəliklərinin tətbiq olunduğunu soruşun. İşləmə vaxtı öhdəliyinin endpoint-i, izləmə yeniləmələrinin çatdırılmasını və ya hər ikisini əhatə edib-etmədiyini dəqiqləşdirin. Bunlar eyni əməliyyat nəticəsi deyil.
Öz təlimat kitabçanızı yaradın: uğursuzluğu kim aşkarlayır, təminatçı ilə kim əlaqə saxlayır, sorğulama və ya başqa ehtiyat variant nə vaxt istifadə olunur və yeniləmələr gecikdikdə müştərilər nə görür. Göndərişə xas məlumat problemini və platforma üzrə kəsintini həll etmək prosesini tələb edin. Eskalasiya yolunuzu ona ehtiyac yaranmazdan əvvəl test edin.
15. İstifadə və xərclər necə hesablanır və biz ayrılsaq nə baş verir?
Hansı əməliyyatların ödənişə və ya istifadə limitlərinə daxil olduğunu soruşun: təqdimetmələr, izlənən göndərişlər, sorğular, bildirişlər və ya başqa vahid. Təklif olunan müqavilə çərçivəsində təkrar qeydiyyatların, yenidən cəhdlərin, qeyri-aktiv göndərişlərin, limitdən artıq istifadənin və test trafikinin necə hesablandığını təsdiqləyin. Xərcləri API demosundan təxmin etmək əvəzinə, tətbiq olunan şərtləri yazılı şəkildə əldə edin.
Həmçinin müqavilənin dayandırılmasını planlaşdırın. Göndəriş tarixçələrini necə ixrac edə biləcəyinizi, girişin nə qədər müddət əlçatan qalacağını və aktiv izləmə qeydlərinə nə olacağını müəyyən edin. İşlək çıxış planı təminatçını dəyişəcəyinizə dair proqnoz deyil; artıq hərəkətdə olan göndərişlərə görünüşü itirməməyin yoludur.
Cavabları istehsal qərarına çevirin
Faydalı işə salınma yoxlamasının üç nəticəsi olur:
- Göndəriş uyğunluğu nəticəsi: hansı izləmə qeydlərinin qəbul edildiyini və hadisələrinin nəzərdə tutulan müştəri və əməliyyat iş axınlarınızı dəstəkləyib-dəstəkləmədiyini göstərən sınaqdan keçirilmiş nümunə.
- İnteqrasiya nəticəsi: autentifikasiya, təkrarlar, yenidən cəhdlər, gecikmiş hadisələr, sxem dəyişkənliyi və buraxılmış yeniləmələrdən bərpa prosesinin nümayiş etdirilməsi.
- Əməliyyat razılaşması: sənədləşdirilmiş limitlər, məlumatların emalı şərtləri, dəstək əlaqələri, xərc fərziyyələri və həll olunmamış risklər üçün məsul şəxslər.
Çoxdaşıyıcılı izləmə API-si istifadə ssenarinizə uyğundursa, qiymətləndiriləcək təminatçılardan biri 17TRACK-dır; onun Tracking API səhifəsi və API sənədləri inteqrasiyanı bu suallara əsasən yoxlamaq üçün başlanğıc nöqtələridir. Eyni standart istənilən təminatçıya tətbiq edilməlidir: sənədlər interfeysin necə işləməsinin nəzərdə tutulduğunu göstərir, öz təmsilçi göndəriş testləriniz isə onun istehsal iş axınınız üçün işləyib-işləmədiyini müəyyən edir. Ona səbəb olan hadisələr yoxlanılmayana qədər müştəri bildirişini və ya istisna avtomatlaşdırmasını işə salmayın.
FAQ
Sandbox testi izləmə API-sini istehsal üçün təsdiqləmək üçün kifayətdirmi?
Xeyr. Sandbox sorğu formatlarını və bəzi xəta emalını yoxlaya bilər, lakin daşıyıcıya xas hadisələri, vaxtlamanı və real marşrutlarınızdakı istisna məlumatlarının faydalılığını qiymətləndirmək üçün canlı göndərişlər lazımdır. Hər ikisindən ayrıca qəbul meyarları ilə istifadə edin.
İzləmə yeniləmələri üçün webhook-lardan istifadə etməliyik, yoxsa sorğulama aparmalıyıq?
Qərarı təminatçının sənədləşdirilmiş çatdırılma seçimlərinə və iş axınınızın gecikməyə dözümlülüyünə əsasən verin. Dəstəkləndikdə webhook-lar təkrar yoxlamalara ehtiyacı azalda bilər, lakin qəbul edən sisteminiz yenidən cəhdləri və təkrarları idarə etməlidir. Sənədləşdirilmiş limitlərə uyğun olaraq sorğulama əsas metod və ya bərpa yolu kimi istifadə edilə bilər.
İzləmə statuslarının uyğunlaşdırılmasında ən çox yayılmış səhv nədir?
Daha konkret biznes iddiası üçün tətik kimi bir geniş statusdan istifadə etmək. Məsələn, yalnız “çatdırıldı” etiketi mübahisəni həll etmək üçün lazım olan sübutu təqdim etməyə bilər. Tətikləri təminatçının həqiqətən təqdim etdiyi əsas hadisə detalları ilə müəyyən edin.
İnteqrasiyanı işə salınmazdan əvvəl kim təsdiqləməlidir?
Mühəndislik etibarlılığı və təhlükəsizliyi; əməliyyat və ya dəstək komandası hadisələrin və istisna iş axınlarının faydalılığını; uyğun məxfilik, hüquq və satınalma məsulları isə məlumatların emalını və kommersiya şərtlərini təsdiqləməlidir. Açıq qalan hər boşluq üçün konkret məsul şəxs təyin edin.


