Перейти к содержанию

API · CHECKLIST

Что проверить перед интеграцией API

Главный риск интеграции обычно не в HTTP-запросе. Он появляется в авторизации, повторных событиях, несовпадении сущностей и ситуациях, когда одна из систем временно недоступна.

Короткий ответ

Главный риск интеграции обычно не в HTTP-запросе. Он появляется в авторизации, повторных событиях, несовпадении сущностей и ситуациях, когда одна из систем временно недоступна.

Есть ли нормальная документация

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

Кто источник истины

Для каждого поля определите владельца. Например, цена меняется в 1С, статус оплаты - в платёжной системе, комментарий менеджера - в CRM. Если обе системы одновременно «главные», синхронизация начинает конфликтовать.

Событие или опрос

Если сервис поддерживает webhooks, обычно лучше реагировать на событие. Если нет - нужен polling с расписанием и контролем повторов. В обоих случаях важно не создавать дубль при повторной доставке.

Ошибки должны быть видимы

Интеграция не должна молча терять заявку. Нужны лог, понятный статус, повторная попытка там, где она безопасна, и способ вручную переотправить проблемную запись.

Проверьте тестовый сценарий

До релиза стоит пройти минимум: успешный запрос, неверные данные, таймаут, повтор webhook, недоступность внешнего сервиса и восстановление после ошибки.

Минимальный пакет для оценки

  • ссылка на документацию API и способ авторизации
  • пример сущности или ответа, который нужно передать
  • описание, что считать успешной синхронизацией и как обрабатывать ошибку

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

ЕСТЬ ЗАДАЧА?

Расскажите
о вашей задаче.

Пришлите ссылку, скриншот или короткое описание. Уточним объём, стоимость и срок до начала работы.

Telegram ↗alexgtup@gmail.com
Добавить ссылку, срок или бюджет +

Это черновик. Вы сами отправите его в Telegram или по почте.