Перш ніж наймати компанію з інтеграції API в Дубаї

На столі три пропозиції. У кожної компанії-інтегратора є портфоліо туристичних сайтів, кожна обіцяє «підключити API авіаквитків до вашого сайту», а найдешевша може почати наступного тижня. У вас агенція в Дейрі, шестеро співробітників і стабільний корпоративний портфель, і вам набридло передруковувати тарифи з екстранету постачальника в повідомлення у WhatsApp. Вибір компанії з інтеграції API в Дубаї, яка виглядає найкомпетентнішою, здається всім рішенням.
Насправді це приблизно третина. Те, від чого залежить, чи продаватиме сайт, немає в жодній із трьох пропозицій, бо це не код. Це питання, з ким підписано договір постачання, на чиє ім'я виписуються квитки, де лежать гроші між бронюванням і випискою і хто оформить повернення, коли клієнт скасує поїздку. Інтегратор може все це з'єднати. Але не може бути нічим із цього замість вас.
Цей текст для власника, який підписуватиме технічне завдання, а не для розробника, який його читатиме.
Що компанія з інтеграції API в Дубаї може зробити, а що ні
Компанія-інтегратор пише код між API постачальника та вашим сайтом: форму пошуку, запит наявності, перевірку ціни перед оплатою, запит на бронювання, екрани з результатом і, якщо це є в обсязі робіт, виклики скасування та повернення. Добрі компанії беруть на себе й нудні, але важливі речі: повторні запити, коли постачальник не відповідає вчасно, логи, за якими можна відстежити невдале бронювання, тестове середовище, що поводиться як бойове.
Чого вона дати не може — це всього, що лежить по той бік коду. Ще до першого рядка агенції потрібні:
- обліковий запис у постачальника на ім'я самої агенції, з доступом до API саме для цього облікового запису;
- право виписки квитків: власна акредитація або консолідатор, який виписує від її імені;
- фінансова домовленість із цим постачальником: депозит, кредитний ліміт або прохідні карткові платежі;
- людина, яка виконує роботу після виписки (void, повернення, перевипуск, зміни розкладу) через API або, якщо інакше ніяк, вручну.
Інтегратор, який пропонує «закрити питання з постачальником», зазвичай пропонує позичити вам свій обліковий запис. Для прототипу це може бути розумний шлях. Для бізнесу це означає, що ваш сайт бронювань працює на стосунках, які вам не належать і які ви не заберете з собою.
Бриф: сім пунктів для технічного завдання
Більшість суперечок з інтегратором починається з речення, якого ніхто не записав. Внесіть ці пункти в документ, який підписуєте, простими словами, і просіть кожну відповідь письмово.
- На чиє ім'я обліковий запис у постачальника та ключі API. На агенцію. Ключі — це облікові дані: вони зберігаються у вашому сховищі паролів, а інтегратор отримує доступ, а не право власності.
- Хто хостить сайт і кому належить домен. Домен зареєстровано на агенцію. Хостинговий акаунт належить агенції, або договір точно описує, як його буде передано.
- Які операції входять в обсяг робіт. Перелічіть поіменно: пошук, ціна, бронювання, виписка, скасування, повернення, зміна. Усе, чого немає в списку, на весь час існування сайту залишиться листом до служби постачальника. Найчастіше бракує повернень і змін, бо їх не показує жодне демо.
- Хто підтримує інтеграцію, коли постачальник змінює API. Постачальники виводять версії з обігу й перейменовують поля. Розробка за фіксованою ціною без пункту про підтримку закінчується того дня, коли зміниться перша версія.
- Що означає передача. Вихідний код у репозиторії, що належить агенції, усі облікові дані та документація, за якою інший розробник зможе продовжити роботу. «Надішлемо вам архів» — це не передача.
- Як доводиться готовність до запуску. Тестове бронювання від пошуку до квитка в тестовому середовищі постачальника, включно зі скасуванням, до того як хтось візьме картку реального клієнта.
- Що відбувається з даними клієнтів. Імена пасажирів, паспортні дані, платіжні референси: де вони зберігаються, хто може їх читати і як їх видаляють.
Для жодного з цих пунктів не потрібна технічна освіта. Кожен дешевше узгодити до розробки, ніж виторговувати після неї.
Три способи вивести контент постачальників на ваш сайт
Найняти інтегратора під API постачальника — один зі шляхів. Варто побачити його поруч із двома іншими, перш ніж комерційна пропозиція вибере за вас.
| Шлях | Хто тримає стосунки з постачальником | Хто підтримує з'єднання робочим | Що агенції ще треба збудувати | Скільки коштує піти |
|---|---|---|---|---|
| Інтегратор підключає ваш сайт до API постачальника | Агенція, якщо так записано в брифі; інакше часто інтегратор | Інтегратор за договором підтримки, або ніхто | Адмінку, націнки, базу клієнтів, звіти, платежі, екрани післяпродажного обслуговування | Небагато, якщо код і ключі ваші; переробку, якщо ні |
| Інтегратор підключає ваш сайт до API платформи | Договори з постачальниками має платформа; агенція має обліковий запис на платформі | Платформа з боку постачальника; інтегратор з вашого боку | Ваш сайт і те, чого не покриває API платформи | Переписати вашу частину під інший API |
| White-label вітрина, яка вже підключена | Платформа, через обліковий запис агенції | Платформа | Контент, цінові рішення, власних клієнтів | Перенести домен і список клієнтів до іншого провайдера |
Сперечатися варто про перший рядок. Він дає найбільше контролю і найбільше перекладає на вас: кожна зміна в постачальника, кожна нова послуга і кожна операція, пропущена в першій версії, стає новим проєктом із новою пропозицією.
Як додати пошук на сайт, який у вас уже є, розібрано в тексті як додати пошук авіаквитків на наявний сайт, а чий API поставити за ним — у тексті що стоїть за постачальником API бронювання авіаквитків. Цей текст — про договір навколо самої роботи.
Де тут ця платформа
Платформа, що стоїть за цим блогом, надає API авіаквитків і готелів. Доступ починається з розмови, а не з ключа, який ви генеруєте самі, бо перші запитання — ті, що вище (які послуги, який ринок, як рухаються гроші), а не який endpoint викликати. Послуги вмикаються для кожного облікового запису окремо, і кожен обліковий запис має власну адмін-панель із власними бронюваннями, клієнтами, націнками та звітами, тож колонка «що ще збудувати» в другому рядку коротша, ніж здається.
Якщо вашу частину будуватиме компанія-інтегратор, проведіть цю розмову до того, як приймете пропозицію, щоб обсяг робіт описував API, до якого вона справді підключатиметься. Почати можна зі сторінки про туристичні API.
Скільки коштує слабкий бриф
Сайт запускається. Пошук працює, ціни схожі на правду, і перше бронювання приходить у четвер увечері. Виписати квиток на ім'я вашої агенції неможливо, бо обліковий запис у постачальника належить інтеграторові й виписує за його домовленістю. З картки клієнта вже списано гроші. У вас бронювання, яке ви не можете ні виписати, ні повернути через власний сайт.
Або все працює рік. Потім постачальник переходить на нову версію API, бронювання зупиняються, а інтегратор, чий договір за фіксованою ціною закінчився на передачі, виставляє пропозицію на новий проєкт. Ви платите, бо єдині, хто розуміє код, — ті, хто цю пропозицію надіслав.
Або інтегратор просто зайнятий іншим. Клієнтові треба виправити ім'я в квитку, операції зміни ніколи не було в обсязі робіт, і двоє ваших співробітників проводять пів дня в листуванні зі службою постачальника. Саме від цієї роботи сайт мав вас звільнити.
Щоразу в брифі бракувало одного речення. Код щоразу був у порядку.