Мазмұнға өту
Блог

Дубайда API интеграция компаниясын жалдамас бұрын

Tekravel редакциясы
Жасанды интеллекттің көмегімен жазылған

Үстелде үш коммерциялық ұсыныс жатыр. Әр интеграция компаниясының туристік сайттардан тұратын портфолиосы бар, әрқайсысы «сайтыңызға әуе билеттерінің API-ін қосуға» уәде береді, ал ең арзаны келесі аптада жұмысқа кірісе алады. Сіз Дейрада алты адамдық агенттік басқарасыз, корпоративтік клиенттеріңіз тұрақты, ал жеткізушінің экстранетінен тарифтерді WhatsApp хабарламаларына көшіре-көшіре шаршадыңыз. Дубайдағы ең білікті көрінетін API интеграция компаниясын таңдау бүкіл шешім сияқты көрінеді.

Бұл шешімнің шамамен үштен бірі ғана. Сайттың сата ма, жоқ па екенін анықтайтын нәрселер үш ұсыныстың ешқайсысында жоқ, өйткені олар код емес. Сұрақ мынада: жеткізуші келісімшартқа кіммен қол қойған, билеттер кімнің атынан рәсімделеді, брондау мен билет рәсімдеу арасында ақша қайда тұрады, ал клиент бас тартқанда қайтарумен кім айналысады. Интегратор мұның бәрін бір-бірімен байланыстыра алады. Бірақ сіздің орныңызға олардың біреуі бола алмайды.

Бұл мәтін техникалық тапсырмаға қол қоятын иесіне арналған, оны оқитын әзірлеушіге емес.

Дубайдағы API интеграция компаниясы не бере алады, не бере алмайды

Интеграция компаниясы жеткізушінің API-і мен сіздің сайтыңыз арасындағы кодты жазады: іздеу формасы, орындардың барын сұрайтын сұраныс, төлем алдындағы бағаны тексеру, брондау сұранысы, нәтижені көрсететін экрандар, ал жұмыс көлемінде жазылса — бас тарту мен қайтару сұраныстары. Жақсы компаниялар іш пыстыратын, бірақ маңызды бөліктерді де өз мойнына алады: жеткізуші уақытында жауап бермегенде қайта әрекет ету, сәтсіз брондауды бақылауға мүмкіндік беретін логтар, жұмыс ортасы сияқты әрекет ететін тест ортасы.

Ол сізге бере алмайтыны — сол кодтың арғы жағындағы барлық нәрсе. Бір жол жазылмай тұрып, агенттікке қажет:

  • агенттіктің өз атына ашылған жеткізуші аккаунты, API қолжетімділігі дәл осы аккаунтқа берілген болуы керек;
  • билет рәсімдеу құқығы — не өз аккредиттеуіңіз, не сіздің атыңыздан билет рәсімдейтін consolidator;
  • сол жеткізушімен қаржылық келісім: депозит, кредиттік желі немесе карта төлемдерін тікелей өткізу;
  • билеттен кейінгі жұмысты (void, қайтару, қайта рәсімдеу, кесте өзгерістері) атқаратын біреу — API арқылы, болмаса қолмен.

«Жеткізуші жағын біз шешеміз» деген интегратор әдетте өз аккаунтын сізге қарызға беруді ұсынады. Прототип үшін бұл қисынды қысқа жол болуы мүмкін. Бизнес үшін бұл брондау сайтыңыз сізге тиесілі емес және өзіңізбен бірге алып кете алмайтын қарым-қатынас үстінде жұмыс істейді деген сөз.

Бриф: техникалық тапсырмаға арналған жеті тармақ

Интегратормен болатын даулардың көбі ешкім жазбаған бір сөйлемнен басталады. Мыналарды қол қоятын құжатыңызға қарапайым тілмен енгізіңіз және әрқайсысына жазбаша жауап талап етіңіз.

  1. Жеткізуші аккаунты мен API кілттері кімнің атында. Агенттіктің. Кілттер — кіру деректері: олар сіздің құпиясөз қоймаңызда сақталады, ал интеграторға меншік емес, қолжетімділік беріледі.
  2. Сайтты кім орналастырады, домен кімде. Домен агенттіктің атына тіркелген. Хостинг аккаунты агенттікке тиесілі, немесе келісімшартта оның қалай берілетіні нақты жазылған.
  3. Жұмыс көлеміне қандай операциялар кіреді. Оларды атымен тізіп жазыңыз: іздеу, баға, брондау, билет рәсімдеу, бас тарту, қайтару, өзгерту. Тізімде жоқтың бәрі сайттың бүкіл өмірінде жеткізуші бөліміне жіберілетін хат болып қала береді. Ең жиі қалып қоятыны — қайтару мен өзгерту, өйткені оларды ешбір демо көрсетпейді.
  4. Жеткізуші API-ін өзгерткенде қолдауды кім жасайды. Жеткізушілер ескі нұсқаларды жабады, өрістердің атын өзгертеді. Қолдау тармағы жоқ тіркелген бағалы жұмыс бірінші нұсқа өзгерген күні аяқталады.
  5. Тапсыру нені білдіреді. Агенттікке тиесілі репозиторийдегі бастапқы код, барлық кіру деректері және басқа әзірлеушіге жұмысты жалғастыруға мүмкіндік беретін құжат. «Сізге zip жібереміз» — бұл тапсыру емес.
  6. Іске қосу қалай дәлелденеді. Жеткізушінің тест ортасында іздеуден билетке дейін, бас тартуды қоса, сынақ брондау — нақты клиенттің картасынан ақша алынбай тұрып.
  7. Клиент деректерімен не болады. Жолаушылардың аты-жөні, паспорт деректері және төлем сілтемелері: қайда сақталады, кім оқи алады және қалай өшіріледі.

Бұлардың ешқайсысы техникалық білімді қажет етпейді. Әрқайсысын әзірлеуге дейін келісу кейін саудаласудан арзанға түседі.

Жеткізуші контентін сайтқа шығарудың үш жолы

Жеткізушінің API-іне интегратор жалдау — бір жол ғана. Коммерциялық ұсыныс сіздің орныңызға таңдау жасамай тұрып, оны қалған екі жолмен қатар қойып көрген жөн.

ЖолЖеткізушімен қарым-қатынас кімдеҚосылымның жұмысын кім қамтамасыз етедіАгенттік бәрібір не құруы керекКетудің құны
Интегратор сайтыңызды жеткізушінің API-іне қосадыБрифте жазылса — агенттікте; әйтпесе көбіне интегратордаҚолдау келісімшарты бар интегратор немесе ешкімӘкімшілік панель, үстеме баға, клиент жазбалары, есептер, төлемдер, қызмет көрсету экрандарыКод пен кілттер сіздікі болса аз; болмаса — қайта құру
Интегратор сайтыңызды платформаның API-іне қосадыЖеткізуші келісімшарттары платформада; агенттікте платформадағы өз аккаунтыЖеткізуші жағында платформа; сіздің жағыңызда интеграторСайтыңыз және платформа API-і қамтымайтын бөлікӨз жағыңызды басқа API-ге қайта жазу
Әлдеқашан қосылған white-label витринаПлатформа, агенттік аккаунты арқылыПлатформаКонтент, баға шешімдері, өз клиенттеріңізДоменді және клиент тізімін басқа провайдерге көшіру

Дауласуға тұрарлық жол — біріншісі. Ол ең көп бақылау береді және ең көп жүкті де сізге артады: жеткізушінің әр өзгерісі, әр жаңа қызмет және бірінші нұсқада қалып қойған әр операция жаңа коммерциялық ұсынысы бар жаңа жобаға айналады.

Бұрыннан бар сайтқа іздеуді қалай қосу керегі бар сайтқа әуе билеттерін іздеуді қосу туралы мақалада, ал оның артында кімнің API-і тұруы керегі әуе билеттерін брондау API жеткізушісінің артында не тұр деген мақалада талқыланған. Бұл мақала сол жұмыстың айналасындағы келісімшарт туралы.

Бұл платформа қай жерде тұр

Осы блогтың артындағы платформа әуе билеттері мен қонақүйлерге арналған API ұсынады. Қолжетімділік автоматты түрде берілетін кілттен емес, әңгімеден басталады, өйткені алғашқы сұрақтар — жоғарыдағылар (қандай қызметтер, қандай нарық, ақша қалай қозғалады), қай endpoint-ті шақыру емес. Қызметтер әр аккаунтқа жеке қосылады, және әр аккаунттың өз брондаулары, клиенттері, үстеме бағалары мен есептері бар өз әкімшілік панелі бар — сондықтан екінші жолдағы «бәрібір не құруы керек» бағаны көрінгеннен қысқа.

Егер сіздің жағыңызды интеграция компаниясы құратын болса, бұл әңгімені коммерциялық ұсынысты қабылдамай тұрып өткізіңіз, сонда жұмыс көлемі ол шынымен қосылатын API-ді сипаттайды. Бастау нүктесі — туристік API беті.

Әлсіз бриф сізге қаншаға түседі

Сайт іске қосылады. Іздеу жұмыс істейді, бағалар дұрыс сияқты, ал бірінші брондау бейсенбі кешке келеді. Оны сіздің атыңызға рәсімдеу мүмкін емес, өйткені жеткізуші аккаунты интеграторға тиесілі және оның келісімі бойынша билет шығарады. Клиенттің картасынан ақша әлдеқашан алынған. Енді қолыңызда өз сайтыңыздан не рәсімдей, не қайтара алмайтын брондау бар.

Немесе бір жыл бойы жұмыс істейді. Содан кейін жеткізуші API-дің жаңа нұсқасына көшеді, брондаулар тоқтайды, ал тіркелген бағалы келісімшарты тапсыру кезінде аяқталған интегратор жаңа жобаға ұсыныс жібереді. Сіз төлейсіз, өйткені кодты түсінетіндер — ұсыныс жіберіп отырғандар ғана.

Немесе интегратор жай ғана басқа жерде бос емес. Клиентке билеттегі атын түзету керек, өзгерту операциясы ешқашан жұмыс көлемінде болмаған, және екі қызметкеріңіз түстен кейінгі уақытын жеткізуші бөліміне хат жазумен өткізеді. Дәл сайт алып тастауы тиіс жұмыс.

Осылардың әрқайсысы — брифте жетіспеген бір сөйлем. Код әр жолы дұрыс болды.

Tekravel редакциясы

Туристік технологиялар бөлімі

Tekravel-тің туристік технологиялар бөлімі сала мамандарына жазады: агенттік иелеріне, консолидаторларға және оларды интеграциялайтын әзірлеушілерге. Әрбір мақала жарияланбас бұрын өзі сипаттайтын платформада тексеріледі.