Интеграция сайта со сторонним сервисом по API

Отвечает на это не описание на сайте вендора, а сам интерфейс. Мы дёргаем несколько методов и смотрим на восемь вещей: документация, авторизация, вебхуки, лимиты, пагинация, идентификатор записи, поведение при ошибке, версионирование. Частый стоп-сигнал — авторизация только сессией браузера: публичного интерфейса нет, и технически остается имитировать работу человека в кабинете. Мы такое делаем, но говорим прямо, что решение хрупкое и ломается от смены верстки кабинета.

Нет, но это другой объем работ и другой риск. Когда описания нет, формат восстанавливается из сетевых запросов кабинета: видны адреса, состав полей и вид ответа. Прочесть это несложно. Проблема более глубокая: никто не обязан держать такой интерфейс неизменным, и владелец может переделать его завтра, никого не предупредив. Мы пишем этот риск в договор отдельной строкой, чтобы вы принимали решение до первой поломки, а не после нее.

Ибо код ответа описывает транспорт, а не результат. Подходящий интерфейс отличает отказ от успеха и объясняет, что именно не так. Непригодный отдает 200 и пустое тело во что бы то ни стало. Это не теория: в магазине профессиональной косметики, который мы мерили 31.07.2026, штатная карта сайта и товарный фид платформы соответствовали коду 200 с нулевым телом — оба источника формально работали. Поэтому успехом мы считаем разобранный ответ с ожидаемыми полями, а не сам факт соединения.

Вебхуки, когда они есть: чужая система сама сообщает об изменении, данные расходятся на секунды. У большинства сервисов их нет, и тогда остается опрос раз в определенный промежуток. Главное здесь не механизм, а названная цифра: между циклами есть окно, в которое обе стороны видят разное. Для остатков это означает, что товар может быть куплен дважды. Размер окна согласовываем к старту и пишем в контракт обмена вместо слова «мгновенный».

Операция не должна исчезнуть – требование, от которого мы не отступаем. Передача становится в очередь и повторяется с нарастающим отступлением, пока не пройдет. Чтобы повторы не наплодили дублей, каждая операция несет идемпотентный ключ: чужая система узнает ее как ту же и обновляет имеющуюся запись. Если очередь не разобралась в согласованное время, ответственный получает уведомление. Без этих трех вещей сбой на чужой стороне становится тихой потерей данных, которую замечают через недели.

Сверка двумя независимыми методами, и делаем мы ее до передачи работы, а не после жалобы. Пример по измерению 31.07.2026: в оптовом B2B-каталоге товаров из Китая объем считали дважды — штатный поиск платформы дал 58 страниц по 100 позиций плюс 30, то есть 5 830 товаров, а карты сайта двух языковых версий дали по 6 232 адреса. адресов, и сойтись они не обязаны — обязана быть разъяснена разница. Тот же порядок действий переносим на прием обмена: счет на источнике, счет на приемнике, разбор различия.

9–22 рабочих дней после разведки; сама разведка длится 2–5 дней, она бесплатна и в срок не входит. Нижний предел – одно направление передачи и один тип записи на документированном API с тестовым контуром. Верхняя — обмен в обе стороны с несколькими типами записей и обратными статусами. Этапы частично идут параллельно: очередь и журнал мы пишем, пока ждем доступа или ответа технического человека на чужой стороне.

Когда-то да, и планировать это честнее, чем обещать вечную работу. Поэтому обмен пишется так, чтобы поломка была заметна: журнал показывает, какой метод начал соответствовать иначе, а уведомление приходит в день сбоя, а не в день, когда не сошелся отчет. Гарантийные 30 дней охватывают ошибки с нашей стороны. Изменения на чужой стороне – новая работа с отдельной оценкой; сервисы с версионированием дают на нее время, сервисы без него не дают.

Скорее всего, нет, и придумывать его мы не станем: чужой обмен извне не проверяется. Показываем, что действительно измерили. Ближе всего к задаче – собственная платформа рерайта описаний товаров: она принимает каталоги из пяти площадок в четырех форматах, готового коннектора под такую ​​смесь не существует. Границу называем открыто: сам импорт извне не верифицируется, мы мерили видимое – 220,6 мс до первого ответа при 140,8 КБ разметки. Ваш интерфейс разберем так же конкретно, до сметы.

Да. Ваш репозиторий, выходцы передаются вместе с работами и инструкцией: где журнал, как перезапустить передачу руками, как отличить сбой чужой стороны от своей. Ключи доступа оформляются на вас, а не на подрядчика, и лежат в переменной среде, а не в коде. Интеграция, которую может сопровождать только ее автор, это зависимость, и продавать такое мы не хотим.