Мучительное создание API

Создавая свой (или правильнее "своё"?) REST API, мы допустили две серьезные ошибки.


Во-первых, один из программистов захотел использовать API для внутреннего проекта. Просто потому, что там был один метод, который сразу делал всё, что ему нужно. А иначе ему пришлось бы напрямую вызывать несколько веб-сервисов.

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

В результате получилась "смесь бульдога с носорогом". На самом деле даже неправильно называть этот сервис "API", скорее это какой-то "Агрегатор". Веб-сервисы нижнего уровня возвращают кучу информации, не нужна нашим партнерам, поэтому API её игнорирует. Но дядьке, как позже оказалось, таки кое-чего не хватает, поэтому ему приходится снова запрашивать у других сервисов информацию, которую те на самом деле уже возвращали.


Вторая проблема. Начальник отдал это проект новому, молодому программисту. Идея была такая: у новичка займет много времени разобраться со существующими проектами, а вот если начать разработку с нуля, то он начнет выдавать результаты чуть ли ни с первых же дней работы. Так-то оно так, но API - это особый проект. Это - шлюз для доступа к большинству существующих веб-сервисов, поэтому, чтобы его создать, нужно хорошо понимать, как работает вся система.

И ещё желательно дать всем параметрам и методам красивые, понятные названия (по возможности совпадающие с теми, которые мы уже используем), и предусмотреть добавление новых возможностей в будущем. Эта - непростая задача, и, наверное, её вообще должны решать аналитики, а не программисты. Ведь, создав интерфейс, ты должен будешь его поддерживать по-крайней мере несколько лет.

Новичок справился с технической частью, но в плане красоты и гибкости получилось ужасно. Он как бы нарочно использовал немного не такие термины, как у нас принято. Я злился, делал ему замечания, но потом плюнул: он отвечает за проект, пусть потом сам мучается. And guess what? Парня сократили, и теперь с этим ненавистным проектом мучаюсь я :)