Otel və aviabilet rezervasiya API-si: bir səyahət, iki rezervasiya

Tapşırıqda yazılıb: "aviabilet axınına otellər əlavə edin, bir ödəniş, bir yekun məbləğ." Məhsul menecerindən gələn bu istək məntiqlidir və bir günlük iş kimi səslənir, çünki aviabilet axtarışınız və ödəniş səhifəniz artıq var. Üç həftə sonra komanda aviaşirkət təsdiq edəndə, amma otel etməyəndə nə olacağını mübahisə edir. Otel və aviabilet rezervasiya API-si iki cür nəticə qaytaran bir inteqrasiya deyil. O, bir səbəti bölüşən iki inteqrasiyadır.
Kod bunu nə qədər tez qəbul etsə, o qədər az hissəsi yenidən yazılır. Aşağıda inteqrasiya bələdçilərinin keçdiyi hissə var: iki yarı necə fərqlənir, hansını əvvəl təsdiqləmək lazımdır və səyahət məlumat modelinizdə nə olmalıdır.
İki yarı eyni davranmır
Hər ikisi qiymət və istinad nömrəsi ilə JSON kimi gəlir, ona görə xəttdə oxşar görünür. İstinadı əldə etdikdən sonra verdikləri vəd isə oxşar deyil.
| Sual | Aviabilet | Otel |
|---|---|---|
| Rezervasiyadan sonra əlinizdə nə var | Hələ bilet olmayan rezerv (PNR) | Adətən artıq satdığınız şeyin özü olan təsdiq |
| Qiymət nə qədər qüvvədədir | Tarifin rezervasiya anında yenidən qiymətləndirilməsinə qədər; bu, axtarışdakından fərqli ola bilər | Tarifin müddəti bitənə qədər; tarif mövcudluq ilə rezervasiya arasında dəyişə bilər |
| Təsdiqi nə verir | Biletin buraxılması, çox vaxt vaxt limiti ilə | Təchizatçının təsdiqi, bəzən dərhal, bəzən gözləmədə |
| Necə geri qaytarılır | Tez tutulsa void, əks halda tarif qaydalarına görə qaytarma, tez-tez cərimə ilə | Tarifin öz siyasətinə görə ləğv; bir çox tarifdə müəyyən vaxta qədər pulsuz |
| Məbləği sonra nə dəyişir | Tarif, vergilər, bəzən tarifin valyutası | Obyektdə ödənilən vergi və haqlar, yemək növü, faktiki verilən otaq |
Bir sətirlə razılaşmaya bilərsiniz, çünki təchizatçılar fərqlidir, amma onun formasına yox: bir yarıda bilet buraxılışı mərhələsi, digərində ləğv pəncərəsi var və onlar zamanda üst-üstə düşmür. Ardıcıllığın aviabilet tərəfini aviabilet rezervasiya API inteqrasiyası yazımızda, otel tərəfindəki yavaş təchizatçı problemini isə otel mövcudluğu API müştərisinin dizaynı yazımızda işıqlandırdıq. Bu material onların bitdiyi yerdən, birləşmə nöqtəsindən başlayır.
Hansını əvvəl rezerv etməli?
Bunun dizayn qərarı olduğunu heç kim demir, halbuki xətanın nəyə başa gələcəyini məhz o müəyyən edir.
Tutaq ki, müştəri eyni tarixlər üçün aviabilet və otel alır. Əvvəl birini, sonra digərini göndərirsiniz. Üç şey ola bilər: hər ikisi alınır, biri uğursuz olur, yaxud biri digəri uğurlu olandan sonra uğursuz olur. Birincisi yaxşı gündür. Digər ikisi dəstək növbənizi müəyyən edir.
Əvvəl bileti buraxsanız və otel sonra imtina etsə, şəhərə yeri olan, amma otağı olmayan, pulu artıq çıxılmış və cərimə daşıyan bileti geri qaytarmalı müştəriniz olur. Əvvəl oteli rezerv etsəniz və aviabilet sonra uğursuz olsa, çox vaxt pulsuz ləğv edə biləcəyiniz otaq sizdə qalır, yəni təmir ucuzdur. Əks risk də realdır, çünki ləğv edilməyən otel tarifi saxlamaq üçün ən pis şeydir, ona görə onu birinci buraxmazdan əvvəl tarifin ləğv şərtlərini oxuyun.
Bu, qanun yox, təcrübə qaydasıdır; məsələ sıranı şüurlu seçməkdir. Geri qaytarması asan olan yarını çətin olandan əvvəl təsdiqləyin, hər hansı biri təsdiqlənməzdən az əvvəl hər iki qiyməti yoxlayın və üç nəticənin hər biri üçün nə etdiyinizi yazın. Rəyçilər nadir hallarda soruşur. Müştərilər həmişə öyrənir.
Bir səyahət, iki rezervasiya
Dayanıqlı forma hər birinin öz istinadı, statusu və şərtləri olan iki rezervasiyaya sahib səyahət qeydidir. Müştəri bir yekun məbləğ görür. Verilənlər bazanız iki sətir görür, yekun isə sizin hesabladığınız cəmdir, təchizatçıda mövcud olan şey deyil.
İki statusu ayrı saxlayın. Otel üçün "təsdiqlənib" ilə aviabilet üçün "buraxılıb" eyni vəziyyət deyil və onları düzləşdirən tək status sütunu gec-tez yarımçıq rezerv edilmiş səyahətin üstünə "rezerv edilib" yazacaq.
Dəyişiklik şərtlərini də ayrı saxlayın və göstərin. Göstərilən yekun məbləğ tarixləri dəyişməyin bir yarıda pulsuz düzəliş, digərində haqq olduğunu gizlədir. Əgər ön hissəniz "tarixi dəyiş"i tək düymə kimi göstərirsə, yalnız bir yarı sürüşə biləndə onun nə edəcəyinə müştəri sizin əvəzinizə kəşf etməzdən əvvəl qərar verin. Eyni şey əlavə haqqa da aiddir: əksər satıcılar kimi onu xidmət üzrə əlavə edirsinizsə, səyahətin yekunu iki əlavə haqdır və bir yarıdakı qaytarma hansı əlavəni qaytardığını bilməlidir. Birləşmiş səyahət pulda bahalaşır, çünki sətirlər müxtəlif təqvimlərdə bağlanır və aviabilet qaytarması otel ləğvi gələndə gəlmir.
Bu platforma haradadır
Açıq deyək: platforma aviabilet və otel API-ləri təqdim edir və giriş özünə xidmət açarı ilə yox, söhbətlə başlayır. Xidmətlər hər kirayəçi üçün ayrıca açılır, ona görə otel satan, tur satmayan kirayəçi tur səthini daşımır. Burada hər iki yarını atomar şəkildə rezerv edən tək çağırış vəd edilmir və elə dizayn etməməlisiniz ki, guya o var. Onlara sahib olduğunuz səyahətin altında iki rezervasiya kimi yanaşın.
Onların ətrafında bir şey qurmazdan əvvəl real çağırışları və şərtləri görmək istəyirsinizsə, səyahət API-ləri səhifəsindən başlayın və rezerv etməyi planlaşdırdığınız sıranı gətirin. Pulsuz girişin nə verdiyinə hələ qərar verirsinizsə, pulsuz otel rezervasiya API-si pulsuzun növlərini izah edir.
Səhvin qiyməti
Bahalı variant səssiz olandır. Müştəriyə şəhərə bilet buraxılıb, otaq isə yoxa çıxıb və ilk xəbəri gecə hava limanından gələn mesajla alırsınız. Daha ucuz, amma yenə real olanlar: bir arxayınedici yekun göstərib qiymət yoxlamasından sonra müştərinin razılaşmadığı ikinci rəqəm çıxaran ödəniş; aviabileti qaytarıb oteli unudan geri ödəmə; təchizatçı başqa cür deyəndə "rezerv edilib" yazan status.
Bunların heç biri ağıllı həll tələb etmir. Səyahətin real obyekt olmasını, sıranın kiminsə yazdığı qərar olmasını və ikisindən biri təsdiqlənməzdən az əvvəl hər iki qiymətin yenidən yoxlanmasını tələb edir. Bunu bir dəfə qurun və ödəniş səhifəsi tapşırığın istədiyi qədər sadə görünə bilər.