Проектирование API имеет значение, потому что, когда люди используют API, они хотят использовать его, не беспокоясь о мелочах, которые не имеют к ним никакого отношения. А для этого разработка должна скрывать детали реализации (что на самом деле происходит). Позвольте мне использовать реальную аналогию в качестве объяснения.

Скажем, вы решили пойти в ресторан. Как насчет французского, например? Когда вы идете в ресторан, то становитесь клиентом. Как клиент ресторана, вы читаете его меню, чтобы узнать, какие блюда можно заказать. Вы решаете попробовать миногу по-бордосски (знаменитое французское рыбное блюдо из области Гасконь). Чтобы заказать выбранную еду, вы говорите с (обычно очень приятным и дружелюбным) человеком, которого называют официантом или официанткой. Спустя некоторое время официант возвращается и приносит заказанное вами блюдо – миногу по-бордосски,– которое приготовили на кухне. Пока вы едите свой вкусный обед, можно задать вам два вопроса?

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

Второе: знаете ли вы, что произошло между моментом, когда официант принял ваш заказ и когда принес его вам? Вы можете догадаться, что официант был на кухне, чтобы отдать заказ повару, который работает один. Этот повар очень старается и уведомляет официанта, когда блюдо будет готово, звоня в маленький колокольчик и крича: «Заказ для столика № 2 готов!» Но сценарий может немного отличаться.

Официант может использовать смартфон, чтобы принять ваш заказ, который мгновенно отображается на сенсорном экране на кухне. А там не одинокий повар, а целая бригада. Как только блюдо готово, один из членов бригады помечает ваш заказ как готовый на сенсорном экране, а официант получает уведомление на свой смартфон. Независимо от количества поваров, вы не знаете рецепт и ингредиенты, используемые для приготовления еды. Независимо от сценария, еда, которую вы заказали, поговорив с официантом, была приготовлена на кухне, и официант принес ее вам. В ресторане вы говорите только с официантом (или официанткой), и вам не нужно знать, что происходит на кухне. Какое отношение все это имеет к API? Самое прямое, как показано на рисунке.