Перейти к содержимому

API-first платформы выручки: на что обращать внимание

API-first платформа делает ваш стек устойчивым к будущим изменениям. Что оценивать, когда вендор заявляет об API-first.

10 min read

API-first revenue-платформы: на что обращать внимание

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

Если вы технический эксперт при выборе платформы, умение различить эти два варианта — одно из самых полезных ваших действий. Ниже — что API-first означает на практике, какие признаки отличают настоящий API-first от формальной галочки и почему для revenue-платформы это важнее, чем для большинства софта. Материал продолжает тему расширяемости из референсной архитектуры современной revenue-платформы.

Что значит API-first

API-first — это архитектурное обязательство. API — основной интерфейс к возможностям платформы, а UI построен поверх того же API, а не лезет в обход в базу данных. Тест прост: можно ли через API сделать всё, что можно сделать в UI? В по-настоящему API-first системе ответ «да», потому что у UI нет привилегированного чёрного хода. Он вызывает те же эндпоинты, что и вы.

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

Признаки, отличающие настоящее от показного

По презентации не определить. Определить можно по документации и нескольким точным вопросам.

Паритет покрытия. Открывает ли API каждую сущность и действие или только удобное для маркетинга подмножество? Спросите про операции, которые вам точно понадобятся. Массовые обновления, управление пользовательскими полями, пути обратной записи, по которым инсайты попадают в системы, где люди действуют. Пробелы здесь — это пробелы, на которые вы наткнётесь, обычно на третьем месяце.

Единообразный дизайн. Единые имена ресурсов, стандартная семантика HTTP, одинаковая пагинация и форматы ошибок во всех эндпоинтах. Непоследовательность означает, что эндпоинты добавляли по одному годами, а не проектировали как систему.

Вебхуки и события. Настоящая платформа сама отправляет вам события, а не только отвечает на опрос. Это необходимо для процессов, близких к реальному времени, описанных в материале Real-Time vs. Batch: когда важна свежесть revenue-данных. Без вебхуков вы вынуждены опрашивать, что медленнее и дороже.

Массовые операции. Revenue-данные имеют большой объём. API, поддерживающий только одну запись за раз, упрётся в лимиты и не справится по таймауту с любой реальной нагрузкой. Полноценные массовые эндпоинты — хороший признак того, что API создавали под настоящий масштаб.

Честные лимиты запросов и курсорная пагинация. Задокументированные разумные лимиты указывают на API, построенный для продакшена, а не для демо.

Общий признак всего перечисленного — качество документации. У API-first компаний подробная, актуальная и богатая примерами документация, потому что от удобства API зависит их собственный продукт. Скудная или устаревшая документация — надёжный индикатор API, который внутри не несёт нагрузки.

Почему именно для revenue-платформ

Revenue-операции идиосинкратичны. У каждой компании процесс продаж, логика территорий, стадии сделок и правила маршрутизации немного свои, и ни один интерфейс вендора не может предусмотреть всё. API-first платформа позволяет закодировать ваш процесс: пользовательские интеграции и автоматизации, которые вендор не мог себе представить, вместо того чтобы подгонять свою работу под инструмент.

От этого зависят две вещи, которые современная revenue-платформа должна делать хорошо. Интеграция прежде всего: платформа находится в центре стека и должна чисто соединяться со всем вокруг. Сильный API делает её жизнеспособным хабом для общего слоя данных, а не очередным хранилищем, доступным только через собственный интерфейс. Затем активация и обратная запись: направление инсайтов в системы действия требует программного контроля над тем, как, когда и куда записываются данные. Без полного API обратная запись ограничена готовыми коннекторами вендора. Самые ценные ваши автоматизации почти всегда те, которые никто заранее не построил.

Качество API затрагивает и управление. Хорошо спроектированный API относится к аутентификации, ограниченному доступу и аудиторскому журналу как к первостепенным вещам, так что программный доступ подчиняется тому же управлению и контролю доступа, что и интерфейс. API, который не может выразить вашу модель разрешений, — это уязвимость безопасности, а не просто неудобство.

Как оценивать

Не верьте на слово фразе «у нас есть API».

Прочтите реальную справку по API до подписания, а не маркетинговую страницу. Её глубина и свежесть расскажут почти всё, что нужно. Прототипируйте самый сложный процесс во время пробного периода. Тот процесс, который пропустили на демо, — именно он покажет, настоящий ли API. Спросите напрямую, использует ли UI тот же публичный API, что и вы, или закрытый внутренний; ответ диагностичен. Явно проверьте поддержку вебхуков и массовых операций, поскольку именно их чаще всего не хватает «приклеенным» API. И убедитесь, что аутентификация и разграничение доступа соответствуют вашей модели безопасности, чтобы программный доступ соблюдал те же права, что и вход человека.

API-first платформа — это та, с которой вы можете расти. Платформа другого типа — та, из которой вы со временем вырастете и будете вынуждены её обходить.

Ключевые выводы

  • API-first означает, что UI — всего лишь ещё один потребитель публичного API. Если API не умеет всего, что умеет UI, это не API-first.
  • Ищите паритет покрытия, единообразный дизайн, вебхуки, массовые эндпоинты, честные лимиты и хорошую документацию. Скудная документация — выдающий признак.
  • RevOps идиосинкратичны, поэтому нужно закодировать собственный процесс, а не подстраиваться под экраны вендора.
  • И интеграция, и обратная запись зависят от полного API. Готовые коннекторы никогда не покрывают самую ценную автоматизацию.
  • Читайте реальную документацию, прототипируйте самый сложный процесс и спрашивайте, совпадают ли UI и публичный API.

API-first архитектура — это разница между платформой, которую вы расширяете, и платформой, с которой вы боретесь, и её стоит проверять напрямую при оценке вариантов revenue orchestration вроде revnewo. Прежде чем принять решение, прототипируйте тот процесс, который пропустили на демо.

See revenue orchestration in action

Unify your revenue data, signals, and plays on one AI-native platform.