Әуе билеттері бағасының API-і: көрінетін сан неге әлі тариф емес

Демо жұмыс істейді. Әзірлеуші әуе билеттері бағасының API-ін ұшуға ең арзан күндер күнтізбесіне қосады, тор сандарға толады да, залдағы әрқайсысы ризашылығын білдіреді. Содан кейін алғашқы нақты клиент күнді таңдап, нәтиже бетінде төлем бетіндегіден аз соманы көреді де, скриншотпен қолдау қызметіне жазады. Ештеңе бұзылған жоқ. API нақ одан сұралғанды істеді: баға туралы сұраққа жауап берді, ал сайт жауапты уәде деп қабылдады.
Баға — жады қысқа ұсыныс
Авиакомпания тарифі орындықтағы тұрақты жапсырма емес. Бұл орындар сатылған сайын ашылып-жабылатын сынып, ал оған байланысты сан жолаушылар құрамына, нақты рейстерге, қатысатын әуежайлар салықтарына және ұсыныс берілген валютаға қарай өзгереді. Баға жауабы — бір сәтте, бір кіріс жиыны үшін алынған снапшот. Оны өткен туралы факт деп қарасаңыз, дұрыс нәрсе жасайсыз; бүгіндегі факт деп қарасаңыз, бір айды қайтарымдарға жұмсайсыз.
Сондықтан әзірлеушіге пайдалы сұрақ тек баға қанша екені емес. Сұрақ — бұл қандай баға, қаншалықты ескі және қате болып шықса, жүйе не істейді.
Барлығы баға аталатын үш сан
Көптеген жеткізушілер құжаттамасында үшеуін де бір жерде қайтарады, жиі бірдей өріс атымен. Бірінші күннен бастап оларды өз дерекқор үлгіңізде бөлек ұстаңыз.
| Күй | Қайдан келеді | Қаншалықты жаңа | Сатуға бола ма? | Не көрсету |
|---|---|---|---|---|
| Қарау бағасы | Жылдамдық пен ауқым үшін жасалған кештелген немесе жиналған іздеу | Ескірген болуы мүмкін, сіздің жолаушыларыңызға есептелмеген | Жоқ | «бастап» деген тұжырым және өзгеруі мүмкін екені туралы белгі |
| Бағаланған ұсыныс | Нақты маршрут, жолаушы түрлері және тариф үшін тікелей сұраныс | Шақыру сәтінде жаңа, мерзімімен немесе қайта бағалау сигналымен | Иә, мерзімі біткенше | Жалпы сома, салықтар бөлек, тариф ережелері |
| Берілген сома | Тапсырыс кезінде авиакомпания немесе беру жүйесі шын мәнінде ұстаған | Түпкілікті | Сатылып қойған | Түбіртек; ұсынысқа салыстырыңыз |
Қарау бағасы күнтізбелер мен «ең арзан» белгілерін мүмкін етеді және бұл құруға тұрарлық нәрсе. Тек ол екінші жолдағымен бір нысан емес. Қате — үшеуі де құйылатын price атты жалғыз өріс.
Іс жүзінде бұл кодта жалауы бар біреу емес, үш бөлек тип немесе кесте дегенді білдіреді. Қарау бағасы шамалы қателесуі мүмкін, өйткені ол тек басуға шақыру. Бағаланған ұсыныс — өз атыңыздан алатын міндеттеме, сондықтан оны алынған уақытымен, оны тудырған кіріспен және жеткізуші тапсырыс кезінде қайта сұрайтын идентификатормен сақтайды. Берілген сома — бухгалтерия. Қолдау қызметі клиенттің хаттағыдан басқа сома неге төлегенін сұрағанда, жауап жолдар арасындағы айырмада жатыр, ал бұл айырманы үшеуін де сақтасаңыз ғана оқи аласыз.
Баға жауабында не болуы керек
Жалаң сан негізінде төлем процесін құруға болмайды. Жеткізушінің үлгі жауабын оқығанда төмендегілерді іздеңіз және еркін мәтін ретінде келгеннің бәріне күмәнмен қараңыз.
- Жауапта көрсетілген, аккаунтыңыздан болжанбаған валюта.
- Базалық тариф пен салықтар бөлек, сонда егжей-тегжей көрсетуге болады және салық өзгерісі тариф өзгерісіне ұқсамайды.
- Баға есептелген жолаушы түрлері. Ересек бағасын үшке көбейту отбасылық тариф емес.
- Құрылымдық дерек ретінде тариф ережелері мен жүк, өйткені арзан нұсқаның клиентке шынымен арзан екенін солар шешеді.
- Мерзім немесе қайта бағалау сигналы: уақыт белгісі немесе тапсырыстан бұрын қайта бағалау қажеттігі туралы нақты мәлімдеме.
Соңғы тармақты көбі өткізіп жібереді. Жауапта ұсыныстың қанша уақыт тірі екенін ештеңе айтпаса, сіз болжап отырсыз, ал бұл болжам өндірісте жасалады.
Тапсырыстан бұрын қайта бағалаңыз, кейін емес
Ең қауіпсіз ырғақтың ішінде ереже бар. Қарау үшін іздеңіз. Клиент маршрут таңдағанда, нақ сол маршрут пен сол жолаушылар үшін тікелей бағаланған ұсыныс сұраңыз. Клиентке сол жалпы соманы көрсетіңіз. Тек содан кейін тапсырыс жасаңыз. Тікелей баға нәтиже бетіндегіден өзгеше болса, мұны төлемге дейін, қарапайым сөзбен айтыңыз, төлемнен кейін емес.
Ортаңғы қадамды өткізсеңіз, айырманы мұраға аласыз. Не клиент көргеннен көбірек алып, төлем бетінде сатуды жоғалтасыз, не төмен санды құрметтеп, айырма өз маржаңыздан кетеді. Шағын агенттік мұны бірнеше рет сіңіре алады; жобалау ретінде емес.
Интеграциядан бұрын мұны жазбаша сұраңыз
Құжаттама сәтті жолды сипаттайды. Ақшаңызды жейтін мінез-құлық қысқа сұрақтар тізімінің жауаптарында, ал бұл жауаптарды қоңыраудан гөрі хатта сақтаған дұрыс.
- Іздеу жауабындағы баға тікелей ме, әлде кештелген бе және бұл жауаптың өзінде көрсетілген бе?
- Нақты маршрут үшін бөлек баға шақыруы бар ма және ол тапсырыстан бұрын міндетті ме?
- Баға ығысса, тапсырыс кезінде не болады: бас тарту, жауаптағы жаңа баға немесе үнсіз жаңа сомамен билет?
- Салықтар мен тасымалдаушы үстемелері қалай бөлінеді және олар бағалау мен беру арасында өзгере ме?
- Баға қандай валютада есептеледі және клиент басқасын көрсе, конвертация қайда жүреді?
- Бағаланған ұсыныс қанша уақыт жарамды болады және мұны қалай білесіз?
Бұл тізімді ресми сұрау хатына көшіріп, жауаптарды жеткізушінің жазбаша растауымен бірге өз құжаттарыңызда сақтаңыз: бір жылдан кейін өндірістегі күтпеген мінез-құлықтың себебін дәл осы хаттан табасыз. Ауызша келісім ертеңгі дауда ештеңе дәлелдемейді, ал жазбаша жауап интеграцияны жобалауға да, команданы жаңа мүшеге үйретуге де негіз болады.
Бұған дәл жауап беретін жеткізуші төлем процесі туралы ойлаған. «Ол әрқашан өзекті» дейтін сізге тексеруге болатын ештеңе айтқан жоқ. Мінез-құлықты өзіңіз сынай алмасаңыз, оның төңірегінде құра бастамас бұрын бүкіл стекке басқаша қарауға себеп бар.
Қате қанша тұрады
Ол сирек қатты дыбыспен сәтсіз болады. Төлем сатысындағы ешкім бағаға жатқызбайтын шағын құлдырау ретінде, «баға өзгеріпті» деп басталатын қолдау өтініштері ретінде, нәтиже бетіне сенген, енді сенбейтін клиент ретінде көрінеді. Қызметкерлер билет бермес бұрын тарифтерді қолмен қайта растай бастайды. Біреу ақырында сақтық үшін бағаларды жоғары дөңгелектейтін ереже ұсынады, сонда сайт адамдар салыстыратын жалғыз экранда қымбат болады. Бұлардың әрқайсысы басында дұрыс қабылдау арзан болған шешімге салынған салық.
Бұл платформа қайда тұр
Платформа әр тенант үшін белсендірілетін ұшу және қонақүй API-ларын ұсынады. Қолжетімділік өзіне-өзі қызмет көрсету кілтінен емес, әңгімеден басталады, сондықтан сізге токен мен лимит кестесін беретін тіркеу пішіні жоқ. Бұл бет кідіріс, қамту немесе тариф санын жарияламайды, өйткені қалай тексеруді көрсете алмайтын санды басудың мәні жоқ. Сіз жасай алатыны — жоғарыдағы сұрақтарды сол әңгімеге әкелу және тек іздеудің емес, бағаланған ұсыныстың жауабын көруді сұрау. Егер осы кезеңде болсаңыз, бастау саяхат API-лары бетінен басталады.