Məzmuna keçin
Bloq

Səyahət API müqayisəsi: təchizatçını yox, oxları qiymətləndirin

Tekravel Redaksiyası
Süni intellektin köməyi ilə yazılıb

Üç tabda üç təchizatçının təqdimatı açıqdır. Hər birində aviaşirkətlərin uzun siyahısı olan bir slayd, otellərin sayı olan bir slayd, sandbox, REST və JSON, bir də dəstək ünvanı var. Cədvəl qurursunuz, hər xanaya işarə qoyursunuz və cədvəl heç-heçə bitir. Funksiya siyahısı kimi aparılan səyahət API müqayisəsi adətən belə bitir və bu, yanlış sonluqdur. Növbəti ilinizi həll edəcək fərqlər yalnız istifadəyə verildikdən sonra görünür: təchizatçıda uğurla keçən, sizin tərəfdə isə timeout-a düşən bronda; heç kimin emal edə bilmədiyi geri ödəmədə; siyahıda olan, amma bu marşrutla bileti buraxıla bilməyən aviaşirkətdə.

Bu yazı həmin qərarı verməli və sonra onu müdafiə etməli olan developer və ya texniki rəhbər üçündür. O, təchizatçıları sıralamır. Sizə müqayisə oxları, vaxtını nasazlıqlara sərf edən sınaq planı və danışdığınız tərəfin təchizatçı, yoxsa başqasının təchizatçısını yenidən satan biri olduğunu tez göstərən qısa suallar verir.

Funksiya siyahısı niyə həmişə heç-heçə bitir

Siyahı bir imkanın olub-olmadığını soruşur. Demək olar ki, hər səyahət API-si demək olar ki, hər sətirə “bəli” deyə bilər, çünki sətirlər marketinq səhifəsi səviyyəsində yazılıb: axtarış, qiymət, bron, ləğv, bilet buraxılışı, webhook, sandbox. Onları fərqləndirən sual cancel-ın olub-olmaması deyil, onu uçuşdan on iki saat əvvəl, cərimə tarifi ilə, kontenti üçüncü tərəfdən gələn marşrutla buraxılmış bron üzərində çağıranda nə baş verməsidir. Siyahıda bunun üçün sütun yoxdur.

İkinci problem də var. Siyahını adətən təchizatçının özü doldurur. Siz onun özü haqqında yazdığını qiymətləndirirsiniz.

Təchizatçılara yox, oxlara əsaslanan səyahət API müqayisəsi

“Təchizatçı × funksiya” şəbəkəsini sınaq dövründə topladığınız sübutlarla özünüzün qiymətləndirdiyi oxlarla əvəz edin. Aşağıdakı cədvəl bizim istifadə edəcəyimiz cədvəldir. Sətirlərin çəkisini fərqli verə bilərsiniz — yalnız otel satan biznes üçün bilet buraxılışı az əhəmiyyətlidir — və qəbul etməzdən əvvəl onunla mübahisə etməyə dəyər.

OxSiyahı nə soruşurƏslində nəyi öyrənmək lazımdırZəif cavab necə səslənir
ƏhatəNeçə aviaşirkət və otel?Sizin bazarlarda bu API ilə neçəsini axtarmaq, bron etmək VƏ bilet buraxmaq və ya təsdiqləmək olurBölgüsüz bir böyük rəqəm
DərinlikLəğv endpoint-i varmı?Hər kontent mənbəyi üzrə bron sonrası hansı əməliyyatlar avtomatlaşdırılıb: void, geri ödəmə, yenidən buraxılış, ad düzəlişi, əlavə xidmətlər“Bununla əməliyyat komandamız məşğul olur”
Qiymətin dəqiqliyiQiymət real vaxtdadırmı?Bron zamanı qiymət axtarışdakından nə qədər tez-tez fərqlənir və API bunu sizə necə bildirir“Qiymətlər həmişə canlıdır”
Xətaların mənasıXətalar sənədləşdirilibmi?Xəta yalnız nəyinsə alınmadığını yox, bronun hansı vəziyyətdə olduğunu deyirmiHər nasazlıq üçün bir ümumi kod
İdempotentlik—Təkrarlanan bron çağırışı ikinci bron yarada bilərmiSükut, sonra “belə hal görməmişik”
Müqavilə üzrə təchizatçı—Bilet kimin müqaviləsi, kimin IATA nömrəsi, kimin BSP-si ilə keçir“Bütün böyük GDS-lərlə işləyirik”
Giriş və dəstəkSandbox varmı?Canlı PNR ilişəndə kim cavab verir və nə qədər tezMüraciət forması və adı olan heç bir əlaqə şəxsi

Bu sətirlərdən ikisinin siyahıda heç sualı yoxdur. Bu təsadüf deyil: işlər pis gedəndə ən baha başa gələn və satış təqdimatının öz-özünə ən az xatırladacağı sətirlər məhz bunlardır.

Əhatə dərinlik demək deyil

Aviaşirkətlər siyahısı istənilən təqdimatın ən yanıldıcı slaydıdır. Bir neçə yüz daşıyıcıdan ibarət siyahı müxtəlif şeylər demək ola bilər və onlardan yalnız biri sizə lazım olandır.

Bu daşıyıcıların bir qismi GDS vasitəsilə gəlir və əvvəldən axıra qədər bron edilib bileti buraxıla bilər. Bir qismi NDC qoşulmaları ilə gəlir; burada axtarış yaxşı işləyə bilər, amma brondan sonrakı xidmət — dəyişikliklər, qismən geri ödəmələr, baqaj əlavəsi — həmin aviaşirkət üçün hələ də əl ilə ola bilər. Bir qismi isə kontenti başqa satıcıdan toplanan lowcost-lardır: onları göstərə, bəzən bron edə bilərsiniz, sonra bilet nəzarət etmədiyiniz bir yolla, müştəriyə vəd edə bilmədiyiniz müddətdə gəlir. Bəziləri isə nə vaxtsa bir tarif axtarış cavabında göründüyü üçün siyahıdadır.

Göstərə bildiyiniz, amma bileti buraxa bilmədiyiniz daşıyıcı əhatə deyil. Pərakəndə məhsul üçün bu, yoxluqdan da pisdir: müştəri onu seçir, ödəyir və gözləyir.

Otellərin də forması eynidir, sadəcə sözlər başqadır. Obyektlərin sayına təchizatçının uyğunlaşdırdığı və uyğunlaşdırmadığı otellər; ötən həftə keşə yazılmış statik qiymətlərlə canlı mövcudluq yan-yana; release müddəti olan allotment nömrələri ilə sərbəst satış fondu daxildir. Satdığınız şəhərlərdə canlı bron edilə bilən obyektlərin sayını soruşun və onların öz təchizatçıları arasında dublikatların necə birləşdirildiyini öyrənin: eyni otelin üç qiymətlə üç dəfə görünməsi gözləyən dəstək müraciətidir.

Praktik yoxlama dardır. Həcminizin çoxunu verən iyirmi marşrutu və iyirmi otel şəhərini yazın — məsələn, Bakı–Dubay, Bakı–İstanbul, Dubay və Antalyada otellər — və təchizatçıdan məhz onları sandbox-da əvvəldən axıra işləyən halda göstərməsini istəyin: axtarış, qiymət, bron, bilet buraxılışı və ya təsdiq, ləğv. Dərinliyi olan təchizatçı bunu səs-küysüz edəcək. Yalnız slaydı olan isə slayddan danışmağa başlayacaq.

Sınaq dövründə nəyi yoxlamalı: xoşbəxt yolları yox, xəta yollarını

Hər sandbox sakit marşrutda ekonom sinfində birtərəfli bileti uğurla bron edir. O, elə bunu nümayiş etdirmək üçün qurulub. Sizin istehsal trafikiniz həyatının xeyli hissəsini digər yollarda keçirəcək və sınaq dövrü onları görmək üçün yeganə ucuz andır.

Sınaqda bu siyahını keçin və API-nin nə qaytardığını sonradan əslində doğru çıxanla yan-yana yazın:

  • Axtarışla bron arasında qiymət dəyişikliyi. Bron çağırışı uğursuz olur, yeni qiymətlə keçir, yoxsa təsdiq istəyən ayrıca cavab qaytarır? İnterfeysiniz mesaj mətnini təhlil etmədən bu halları ayırd edə bilirmi?
  • Vaxtı keçmiş təklif. Axtarış edin, təchizatçının bildirdiyi təklif müddətindən çox gözləyin, sonra bron edin. Vaxtın keçməsi ayrıca xətadır, yoxsa “təchizatçı əlçatmazdır” ilə eyni xəta?
  • Bron anında tükənib. Qiymətlə bron arasında yox olan fond. Bron hansı vəziyyətdədir və ödəniş bloku buraxılırmı?
  • Timeout-dan sonra təkrar. Bron sorğusu göndərin, cavabdan əvvəl bağlantını kəsin və onu yenidən göndərin. İndi bir PNR-iniz var, yoxsa iki? Təkcə bu test təchizatçı haqqında sınağın qalan hissəsinin hamısından çox şey deyir.
  • Bron yaradılıb, bilet buraxılmayıb. API mövcud olan, amma bileti buraxılmamış PNR haqqında məlumat verə bilirmi və buraxılış son tarixini deyirmi?
  • Qismən nasazlıq. Bir neçə nömrəlik otel sorğusu: biri təsdiqlənir, digəri yox. Gediş-dönüş uçuşu: seqmentlər müxtəlif mənbələrdən gəlir.
  • Pulsuz pəncərədən kənar ləğv. Cərimə təsdiqdən əvvəl deyilir, yoxsa onu fakturada görürsünüz?
  • Təchizatçının işləməməsi. Təchizatçıdan bunu necə simulyasiya etməyi soruşun. Bilmirsə, müştərilərinin sistemin o zaman necə davrandığını necə öyrəndiyini soruşun.

Hər halda iki şeyi qiymətləndirirsiniz. Birincisi: API bronun vəziyyəti barədə sizə həqiqəti deyirmi? İkincisi: kodunuz sərbəst mətni oxuyan insan olmadan bu həqiqətə əsasən hərəkət edə bilirmi? Aydın şəkildə uğursuz olan API ilə yaşamaq qeyri-müəyyən şəkildə uğurlu olandan asandır.

Uçuş tərəfi haqqında daha ətraflı aviabilet bron API sənədlərinin demədikləri yazısında, yavaş otel təchizatçıları üçün klient dizaynı haqqında isə otel mövcudluğu barədə yazıda danışmışıq. Hər ikisi sınaq planına yaxşı əlavədir.

Nazik aqreqatoru üzə çıxaran suallar

Aqreqatorda pis heç nə yoxdur. Səyahət kontentinin çoxu satıcıların çoxuna məhz onlardan biri vasitəsilə çatır. Risk nazik aqreqatordadır: başqa bir qatın API-sini yenidən satan, üstünə marja qoyan, amma nə təchizatçı müqaviləsinə, nə də əməliyyat masasına sahib olan qat. Nəsə qırılanda cavab iki şirkət yuxarı gedib geri qayıtmalıdır.

Beş sual bunu tez üzə çıxarır:

  1. Bu bron üzrə müqavilə təchizatçısı kimdir? O, aviaşirkət və ya otellə kimin müqaviləsinə əsaslanır?
  2. Bilet kimin IATA nömrəsi və kimin BSP-si ilə keçir? Cavab “tərəfdaşın” olsa, tarif qaydası pozulanda ADM-i kimin aldığını soruşun.
  3. Mən cancel çağıranda sizin tərəfdə nə baş verir? Təchizatçıya avtomatik çağırış, yoxsa bir insanın götürdüyü növbə?
  4. Yuxarı mənbənin xətasını görə bilərəmmi? Nazik qat adətən hər nasazlığı bir koda sıxır, çünki aldığı xətaları tam başa düşmür.
  5. İlişmiş canlı bron üçün kimə zəng edirəm və onlar kimə zəng edir? Halqaları sayın.

Bu cavabların heç biri tək başına diskvalifikasiya etmir. Müqavilədə debet notunu kimin daşıdığı aydın yazılıbsa, tərəfdaşın IATA nömrəsi də qaydasında ola bilər. Vacib olan təchizatçının dəqiq və tez cavab verməsidir. Bu gün aldığınız qeyri-müəyyən cavablar sonra, istehsalda, daha pis saatda alacağınız cavablardır.

Səhv seçim sizə nəyə başa gəlir

İnteqrasiya ucuz hissədir. Baha hissələr sonra gəlir və heç bir smetada görünmür.

İkiqat bron xətası iki dəfə ödəniş tutulan müştəri və əl ilə tapılıb ləğv edilməli PNR deməkdir — bəlkə də pulsuz void pəncərəsi bağlandıqdan sonra. Mənbədə uğurla keçən, sizin tərəfdə isə xəta kimi yazılan bron saxlanılan, sonra avtomatik ləğv olunan yer və bron etdirdiyinə inanan müştəri deməkdir. Göstərilən, amma bileti buraxıla bilməyən daşıyıcı geri ödəmə, üzr və bir daha qayıtmayan müştəri deməkdir. Təchizatçının marşrutunun pozduğu tarif qaydasına görə ADM biletin sahibinə gəlir — bunun siz olub-olmadığınızı əvvəlcədən dəqiqləşdirin.

Bir də keçid xərci var. Qəbul etdiyiniz hər təchizatçı qəribəliyi — iki məna daşıyan status kodu, bəzən mətn olan sahə — sizin məlumat modelinizə düşür. İki ildən sonra API seçimi artıq bir sprintdə əvəz edə biləcəyiniz inteqrasiya deyil; bu, bron cədvəlinizin formasıdır. İndi diqqətlə müqayisə etməyin əsl səbəbi budur.

Bizim API bu metoda necə uyğun gəlir

Biz aviabilet və otel API-ləri təqdim edirik. Giriş self-service açarla yox, söhbətlə başlayır; bəzi developerlər bunu yavaş sayır. Səbəb odur ki, yuxarıdakı suallar məhz bu söhbətdə hər iki tərəfə verilir — hansı marşrut və şəhərlər lazımdır, hansı kontentin biletini həqiqətən buraxa və ya təsdiqləyə biləcəksiniz, brondan sonra nəyə kim baxır. Müqayisə aparırsınızsa, bu siyahını özünüzlə gətirin. Həmin söhbət səyahət API-ləri səhifəsində başlayır.

Nə seçsəniz də, təqdimata görə yox, sınaq jurnalına görə seçin. Təqdimat təchizatçının nə olmaq istədiyini deyir. Xəta yolları onun nə olduğunu.

Tekravel Redaksiyası

Səyahət texnologiyaları masası

Tekravel-in səyahət texnologiyaları masası sənaye üçün yazır: agentlik sahibləri, konsolidatorlar və onları inteqrasiya edən developerlər. Hər məqalə dərc olunmazdan əvvəl təsvir etdiyi platformada yoxlanılır.