Антипример API: как не следует проектировать интерфейсы
Ключевые факты
- 1 API TextVerified используется как пример плохого дизайна.
- 2 Получение номера телефона требует четырех последовательных запросов.
- 3 Каждый запрос возвращает ссылку на следующий шаг вместо конечных данных.
- 4 Номер телефона выдается без кода страны.
- 5 Такой подход усложняет автоматизацию и интеграцию.
Автор демонстрирует пример крайне неэффективного API, используя гипотетический сценарий взаимодействия с сервисом TextVerified. Вместо прямого получения номера телефона после запроса аренды, API возвращает серию ссылок, требующих последовательных запросов. Изначальный запрос аренды приводит к получению ссылки на информацию о заказе, которая, в свою очередь, содержит ссылку на данные об аренде. Только после четвертого запроса удается получить искомый номер телефона, который к тому же выдается без кода страны. Такой подход к проектированию API значительно усложняет автоматизацию и интеграцию, увеличивая количество необходимых шагов и потенциальных точек отказа. Автор подчеркивает, что подобная архитектура является антипаттерном и должна быть избегнута при разработке API.