Внешние API партнёров: не верить документации, верить боевому тесту

Что случилось. Готовясь к разговору с потенциальной школой-клиентом, мы изучили API GetCourse — платформы, на которой ведут курсы многие наши кандидаты. Документация обещала REST API, но реального исходящего вебхука «событие произошло → нам прилетело уведомление» там нет. Реалтайм-связь работает только через внутренний механизм «Call URL», который настраивается отдельно в личном кабинете каждого клиента.

Почему это важно. Легко было бы прочитать документацию, увидеть слово «API» и пообещать школе: «синхронизация прогресса ученика готова, подключим за день». На практике любая внешняя платформа — это не абстрактная спецификация, а конкретное поведение на конкретном тарифе конкретного клиента. Расхождения между «как написано» и «как работает» всплывают только на боевых данных.

Что сделали иначе. Перестали формулировать интеграцию как «уже готово» и стали говорить прямо: часть фич зависит от API GetCourse, и мы это соберём вместе на ваших реальных данных, а не сделаем по слепому чтению документации. В переговорах с куратором школы эта честность сработала лучше, чем обещание готовой кнопки — собеседник прямо сказал, что ценит, когда статус интеграции называют прототипом, а не готовым продуктом.

Почему это важно для вас. Если у вас уже есть платформа — CRM для зачислений, учётная система, телефония — мы не будем рассказывать, что «всё подключится само», основываясь на чужой документации. Мы прямо скажем, что показали бы на ваших тестовых данных, а что — только предположение, пока не увидели API живьём.