Перед тем как нанять компанию API-интеграции в Дубае

На столе три сметы. У каждой компании есть портфолио туристических сайтов, каждая обещает «подключить API авиабилетов к вашему сайту», а самая дешёвая готова начать на следующей неделе. У вас агентство в Дейре, шесть сотрудников и стабильный корпоративный портфель, и вы устали перепечатывать тарифы из экстранета поставщика в сообщения WhatsApp. Кажется, что выбрать самую толковую компанию API-интеграции в Дубае — это и есть всё решение.
Это примерно треть решения. То, от чего зависит, будет ли сайт продавать, не входит ни в одну из трёх смет, потому что это не код. Это вопросы о том, с кем подписан договор у поставщика, на чьё имя выписываются билеты, где лежат деньги между бронированием и выпиской и кто занимается возвратом, когда клиент отменяет поездку. Интегратор может всё это связать между собой. Стать чем-то из этого вместо вас он не может.
Текст написан для владельца, который будет подписывать техническое задание, а не для разработчика, который будет его читать.
Что компания API-интеграции в Дубае может сделать, а что нет
Компания-интегратор пишет код между API поставщика и вашим сайтом: форму поиска, запрос наличия мест, проверку цены перед оплатой, запрос на бронирование, экраны с результатом и — если это прописано в объёме работ — вызовы отмены и возврата. Хорошие интеграторы берут на себя и скучные, но важные вещи: повторные запросы, когда поставщик не отвечает вовремя, журналы, по которым можно проследить сорвавшееся бронирование, тестовую среду, которая ведёт себя как боевая.
Чего интегратор дать не может — так это всего, что находится по ту сторону кода. До того как будет написана первая строка, агентству нужны:
- аккаунт у поставщика на имя самого агентства, с доступом к API, выданным именно этому аккаунту;
- право выписки билетов — собственная аккредитация или консолидатор, который выписывает от вашего имени;
- финансовая схема с этим поставщиком: депозит, кредитная линия или проведение карточных платежей;
- кто-то, кто делает работу после выписки (войды, возвраты, переоформления, изменения расписания) — через API или, если не выйдет, вручную.
Интегратор, который предлагает «решить вопрос с поставщиком», обычно предлагает одолжить вам свой аккаунт. Для прототипа это разумный короткий путь. Для бизнеса это означает, что ваш сайт работает на отношениях, которые принадлежат не вам и которые вы не сможете забрать с собой.
Задание: семь пунктов для договора
Большинство споров с интегратором начинаются с фразы, которую никто не записал. Внесите эти пункты в документ, который подписываете, простыми словами, и просите ответ на каждый в письменном виде.
- На чьё имя открыт аккаунт у поставщика и выданы ключи API. На агентство. Ключи — это учётные данные: они хранятся в вашем менеджере паролей, а интегратор получает доступ, а не право собственности.
- Кто размещает сайт и на кого зарегистрирован домен. Домен зарегистрирован на агентство. Хостинг-аккаунт принадлежит агентству, либо в договоре точно описано, как он передаётся.
- Какие операции входят в объём работ. Перечислите их поимённо: поиск, цена, бронирование, выписка, отмена, возврат, изменение. Всё, чего нет в списке, на весь срок жизни сайта останется письмом в отдел поставщика. Чаще всего забывают возвраты и изменения — их никогда не показывают на демо.
- Кто поддерживает интеграцию, когда поставщик меняет API. Поставщики отключают старые версии и переименовывают поля. Разработка по фиксированной цене без пункта о поддержке заканчивается в тот день, когда меняется первая версия.
- Что значит «передача проекта». Исходный код в репозитории, который принадлежит агентству, все учётные данные и документ, по которому другой разработчик сможет продолжить работу. «Пришлём вам архив» — это не передача.
- Как подтверждается запуск. Тестовое бронирование от поиска до билета в тестовой среде поставщика, включая отмену, — до того, как кто-либо примет карту настоящего клиента.
- Что происходит с данными клиентов. Имена пассажиров, паспортные данные, платёжные реквизиты: где хранятся, кто имеет к ним доступ и как удаляются.
Ни один пункт не требует технической подготовки. И каждый дешевле согласовать до разработки, чем выторговывать после.
Три способа вывести контент поставщика на ваш сайт
Нанять интегратора под API поставщика — лишь один путь. Стоит увидеть его рядом с двумя другими, прежде чем выбор за вас сделает смета.
| Путь | У кого отношения с поставщиком | Кто поддерживает подключение | Что агентству всё равно строить | Во что обходится уход |
|---|---|---|---|---|
| Интегратор подключает ваш сайт к API поставщика | У агентства, если это прописано; иначе часто у интегратора | Интегратор по договору поддержки — или никто | Админку, наценки, базу клиентов, отчёты, платежи, экраны обслуживания | Немного, если код и ключи ваши; переделку с нуля, если нет |
| Интегратор подключает ваш сайт к API платформы | Договоры с поставщиками у платформы; у агентства — аккаунт на платформе | Платформа — со стороны поставщика; интегратор — с вашей стороны | Ваш сайт и то, чего не покрывает API платформы | Переписать вашу часть под другой API |
| Готовая витрина white-label с уже подключённым контентом | Платформа, через аккаунт агентства | Платформа | Контент, ценовые решения, собственные клиенты | Перенос домена и списка клиентов к другому провайдеру |
Спорить стоит о первой строке. Она даёт больше всего контроля и больше всего взваливает на вас: каждое изменение у поставщика, каждая новая услуга и каждая операция, забытая в первой версии, превращаются в новый проект с новой сметой.
Как встроить поиск в сайт, который у вас уже есть, разобрано в статье о добавлении поиска авиабилетов на существующий сайт, а чей API поставить за ним — в тексте о том, что стоит за поставщиком API авиабилетов. Здесь речь о договоре вокруг работы.
Где здесь эта платформа
Платформа, на которой работает этот блог, открывает API авиабилетов и отелей. Доступ начинается с разговора, а не с ключа, выданного автоматически, потому что первые вопросы — те же, что выше (какие услуги, какой рынок, как движутся деньги), а не какой эндпоинт вызывать. Услуги включаются для каждого аккаунта отдельно, и у каждого аккаунта своя админ-панель со своими бронированиями, клиентами, наценками и отчётами — поэтому колонка «что всё равно строить» во второй строке короче, чем кажется.
Если вашу сторону будет строить компания-интегратор, проведите этот разговор до того, как примете смету, — чтобы объём работ описывал тот API, к которому она действительно будет подключаться. Начинается всё со страницы travel API.
Во что обходится слабое задание
Сайт запущен. Поиск работает, цены выглядят правильно, и первое бронирование приходит в четверг вечером. Выписать его на ваше имя нельзя: аккаунт у поставщика принадлежит интегратору и выписывает по его схеме. Карта клиента уже списана. У вас на руках бронирование, которое вы не можете ни выписать, ни вернуть через собственный сайт.
Или всё работает год. Потом поставщик переходит на новую версию API, бронирования останавливаются, а интегратор, чей договор с фиксированной ценой закончился при передаче, присылает смету на новый проект. Вы платите, потому что код понимают только те, кто присылает смету.
Или интегратор просто занят другими клиентами. Клиенту нужно исправить имя в билете, операции изменения в объёме работ не было, и двое ваших сотрудников полдня переписываются с отделом поставщика. Ровно ту работу, которую сайт должен был убрать.
Каждый из этих случаев — одна фраза, которой не хватило в задании. Код при этом каждый раз был в порядке.