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

Үстелде үш коммерциялық ұсыныс жатыр. Әр интеграция компаниясының туристік сайттардан тұратын портфолиосы бар, әрқайсысы «сайтыңызға әуе билеттерінің API-ін қосуға» уәде береді, ал ең арзаны келесі аптада жұмысқа кірісе алады. Сіз Дейрада алты адамдық агенттік басқарасыз, корпоративтік клиенттеріңіз тұрақты, ал жеткізушінің экстранетінен тарифтерді WhatsApp хабарламаларына көшіре-көшіре шаршадыңыз. Дубайдағы ең білікті көрінетін API интеграция компаниясын таңдау бүкіл шешім сияқты көрінеді.
Бұл шешімнің шамамен үштен бірі ғана. Сайттың сата ма, жоқ па екенін анықтайтын нәрселер үш ұсыныстың ешқайсысында жоқ, өйткені олар код емес. Сұрақ мынада: жеткізуші келісімшартқа кіммен қол қойған, билеттер кімнің атынан рәсімделеді, брондау мен билет рәсімдеу арасында ақша қайда тұрады, ал клиент бас тартқанда қайтарумен кім айналысады. Интегратор мұның бәрін бір-бірімен байланыстыра алады. Бірақ сіздің орныңызға олардың біреуі бола алмайды.
Бұл мәтін техникалық тапсырмаға қол қоятын иесіне арналған, оны оқитын әзірлеушіге емес.
Дубайдағы API интеграция компаниясы не бере алады, не бере алмайды
Интеграция компаниясы жеткізушінің API-і мен сіздің сайтыңыз арасындағы кодты жазады: іздеу формасы, орындардың барын сұрайтын сұраныс, төлем алдындағы бағаны тексеру, брондау сұранысы, нәтижені көрсететін экрандар, ал жұмыс көлемінде жазылса — бас тарту мен қайтару сұраныстары. Жақсы компаниялар іш пыстыратын, бірақ маңызды бөліктерді де өз мойнына алады: жеткізуші уақытында жауап бермегенде қайта әрекет ету, сәтсіз брондауды бақылауға мүмкіндік беретін логтар, жұмыс ортасы сияқты әрекет ететін тест ортасы.
Ол сізге бере алмайтыны — сол кодтың арғы жағындағы барлық нәрсе. Бір жол жазылмай тұрып, агенттікке қажет:
- агенттіктің өз атына ашылған жеткізуші аккаунты, API қолжетімділігі дәл осы аккаунтқа берілген болуы керек;
- билет рәсімдеу құқығы — не өз аккредиттеуіңіз, не сіздің атыңыздан билет рәсімдейтін consolidator;
- сол жеткізушімен қаржылық келісім: депозит, кредиттік желі немесе карта төлемдерін тікелей өткізу;
- билеттен кейінгі жұмысты (void, қайтару, қайта рәсімдеу, кесте өзгерістері) атқаратын біреу — API арқылы, болмаса қолмен.
«Жеткізуші жағын біз шешеміз» деген интегратор әдетте өз аккаунтын сізге қарызға беруді ұсынады. Прототип үшін бұл қисынды қысқа жол болуы мүмкін. Бизнес үшін бұл брондау сайтыңыз сізге тиесілі емес және өзіңізбен бірге алып кете алмайтын қарым-қатынас үстінде жұмыс істейді деген сөз.
Бриф: техникалық тапсырмаға арналған жеті тармақ
Интегратормен болатын даулардың көбі ешкім жазбаған бір сөйлемнен басталады. Мыналарды қол қоятын құжатыңызға қарапайым тілмен енгізіңіз және әрқайсысына жазбаша жауап талап етіңіз.
- Жеткізуші аккаунты мен API кілттері кімнің атында. Агенттіктің. Кілттер — кіру деректері: олар сіздің құпиясөз қоймаңызда сақталады, ал интеграторға меншік емес, қолжетімділік беріледі.
- Сайтты кім орналастырады, домен кімде. Домен агенттіктің атына тіркелген. Хостинг аккаунты агенттікке тиесілі, немесе келісімшартта оның қалай берілетіні нақты жазылған.
- Жұмыс көлеміне қандай операциялар кіреді. Оларды атымен тізіп жазыңыз: іздеу, баға, брондау, билет рәсімдеу, бас тарту, қайтару, өзгерту. Тізімде жоқтың бәрі сайттың бүкіл өмірінде жеткізуші бөліміне жіберілетін хат болып қала береді. Ең жиі қалып қоятыны — қайтару мен өзгерту, өйткені оларды ешбір демо көрсетпейді.
- Жеткізуші API-ін өзгерткенде қолдауды кім жасайды. Жеткізушілер ескі нұсқаларды жабады, өрістердің атын өзгертеді. Қолдау тармағы жоқ тіркелген бағалы жұмыс бірінші нұсқа өзгерген күні аяқталады.
- Тапсыру нені білдіреді. Агенттікке тиесілі репозиторийдегі бастапқы код, барлық кіру деректері және басқа әзірлеушіге жұмысты жалғастыруға мүмкіндік беретін құжат. «Сізге zip жібереміз» — бұл тапсыру емес.
- Іске қосу қалай дәлелденеді. Жеткізушінің тест ортасында іздеуден билетке дейін, бас тартуды қоса, сынақ брондау — нақты клиенттің картасынан ақша алынбай тұрып.
- Клиент деректерімен не болады. Жолаушылардың аты-жөні, паспорт деректері және төлем сілтемелері: қайда сақталады, кім оқи алады және қалай өшіріледі.
Бұлардың ешқайсысы техникалық білімді қажет етпейді. Әрқайсысын әзірлеуге дейін келісу кейін саудаласудан арзанға түседі.
Жеткізуші контентін сайтқа шығарудың үш жолы
Жеткізушінің API-іне интегратор жалдау — бір жол ғана. Коммерциялық ұсыныс сіздің орныңызға таңдау жасамай тұрып, оны қалған екі жолмен қатар қойып көрген жөн.
| Жол | Жеткізушімен қарым-қатынас кімде | Қосылымның жұмысын кім қамтамасыз етеді | Агенттік бәрібір не құруы керек | Кетудің құны |
|---|---|---|---|---|
| Интегратор сайтыңызды жеткізушінің API-іне қосады | Брифте жазылса — агенттікте; әйтпесе көбіне интеграторда | Қолдау келісімшарты бар интегратор немесе ешкім | Әкімшілік панель, үстеме баға, клиент жазбалары, есептер, төлемдер, қызмет көрсету экрандары | Код пен кілттер сіздікі болса аз; болмаса — қайта құру |
| Интегратор сайтыңызды платформаның API-іне қосады | Жеткізуші келісімшарттары платформада; агенттікте платформадағы өз аккаунты | Жеткізуші жағында платформа; сіздің жағыңызда интегратор | Сайтыңыз және платформа API-і қамтымайтын бөлік | Өз жағыңызды басқа API-ге қайта жазу |
| Әлдеқашан қосылған white-label витрина | Платформа, агенттік аккаунты арқылы | Платформа | Контент, баға шешімдері, өз клиенттеріңіз | Доменді және клиент тізімін басқа провайдерге көшіру |
Дауласуға тұрарлық жол — біріншісі. Ол ең көп бақылау береді және ең көп жүкті де сізге артады: жеткізушінің әр өзгерісі, әр жаңа қызмет және бірінші нұсқада қалып қойған әр операция жаңа коммерциялық ұсынысы бар жаңа жобаға айналады.
Бұрыннан бар сайтқа іздеуді қалай қосу керегі бар сайтқа әуе билеттерін іздеуді қосу туралы мақалада, ал оның артында кімнің API-і тұруы керегі әуе билеттерін брондау API жеткізушісінің артында не тұр деген мақалада талқыланған. Бұл мақала сол жұмыстың айналасындағы келісімшарт туралы.
Бұл платформа қай жерде тұр
Осы блогтың артындағы платформа әуе билеттері мен қонақүйлерге арналған API ұсынады. Қолжетімділік автоматты түрде берілетін кілттен емес, әңгімеден басталады, өйткені алғашқы сұрақтар — жоғарыдағылар (қандай қызметтер, қандай нарық, ақша қалай қозғалады), қай endpoint-ті шақыру емес. Қызметтер әр аккаунтқа жеке қосылады, және әр аккаунттың өз брондаулары, клиенттері, үстеме бағалары мен есептері бар өз әкімшілік панелі бар — сондықтан екінші жолдағы «бәрібір не құруы керек» бағаны көрінгеннен қысқа.
Егер сіздің жағыңызды интеграция компаниясы құратын болса, бұл әңгімені коммерциялық ұсынысты қабылдамай тұрып өткізіңіз, сонда жұмыс көлемі ол шынымен қосылатын API-ді сипаттайды. Бастау нүктесі — туристік API беті.
Әлсіз бриф сізге қаншаға түседі
Сайт іске қосылады. Іздеу жұмыс істейді, бағалар дұрыс сияқты, ал бірінші брондау бейсенбі кешке келеді. Оны сіздің атыңызға рәсімдеу мүмкін емес, өйткені жеткізуші аккаунты интеграторға тиесілі және оның келісімі бойынша билет шығарады. Клиенттің картасынан ақша әлдеқашан алынған. Енді қолыңызда өз сайтыңыздан не рәсімдей, не қайтара алмайтын брондау бар.
Немесе бір жыл бойы жұмыс істейді. Содан кейін жеткізуші API-дің жаңа нұсқасына көшеді, брондаулар тоқтайды, ал тіркелген бағалы келісімшарты тапсыру кезінде аяқталған интегратор жаңа жобаға ұсыныс жібереді. Сіз төлейсіз, өйткені кодты түсінетіндер — ұсыныс жіберіп отырғандар ғана.
Немесе интегратор жай ғана басқа жерде бос емес. Клиентке билеттегі атын түзету керек, өзгерту операциясы ешқашан жұмыс көлемінде болмаған, және екі қызметкеріңіз түстен кейінгі уақытын жеткізуші бөліміне хат жазумен өткізеді. Дәл сайт алып тастауы тиіс жұмыс.
Осылардың әрқайсысы — брифте жетіспеген бір сөйлем. Код әр жолы дұрыс болды.