API каталога запчастей: что спросить до подписания договора

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

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

Что считается одним запросом

Первый и главный. Один автомобиль или одно обращение к серверу? За время подбора интерфейс обращается к данным десятки раз: определить машину, получить дерево, раскрыть узел, забрать список артикулов.

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

Есть ли схемы узлов и в каком виде

Схема с пронумерованными выносками это то, ради чего каталог покупают. Спрашивайте конкретно: приходит ли картинка, приходят ли координаты выносок, привязаны ли они к артикулам.

Если координат нет, кликабельную схему вы не построите, и останется список номеров. Продавать по нему можно, но это уже другой продукт.

Можно ли кешировать ответы

Вопрос про деньги. Один и тот же автомобиль возвращается на сайт по нескольку раз: человек ушёл подумать, вернулся, посоветовался. Если кеширование запрещено договором, каждый возврат это новый запрос.

Спрашивайте три вещи: разрешено ли кеширование в принципе, на какой срок, и что именно можно хранить. Бывает, что дерево узлов хранить можно, а цены нельзя.

Ограничение частоты обращений

Сколько обращений в секунду разрешено и что происходит при превышении: очередь, ошибка или блокировка ключа. Формулировка «разумное использование» в договоре означает, что решать будут за вас и постфактум.

Что приходит, когда автомобиль не найден

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

Привязка ключа

К домену, к адресу сервера или ни к чему? Если к домену, уточните, как будет работать разработка на локальной машине и на тестовом стенде. Иначе программист упрётся в это на первом же дне.

Что происходит при сбое у поставщика

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

Хороший поставщик отвечает на все эти вопросы конкретными числами. Уклончивость на этапе продажи не улучшится после оплаты.

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