Что такое API? [Быстрое чтение]

Если вы не разработчик, но работаете в сфере технологий, термин API, вероятно, вы понимаете в разговорном смысле. Вы, вероятно, знаете, что это означает (интерфейс прикладного программирования), и, возможно, ваши команды используют API для выполнения своей работы — или, может быть, это даже сам продукт (например, Twilio SendGrid).

Но что такое API и как они работают?

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

В этом посте объясняется, как работают API, как разработчики их создают и как их использовать (с реальными примерами).

Как работают API?

То, как веб-браузеры взаимодействуют с серверами, является фундаментальным принципом API. Сеть — это набор удаленных серверов, разбросанных по всей планете. Когда вы открываете браузер и вводите веб-сайт, браузер обращается к серверу клиента (независимо от того, какое приложение или сервер, на котором размещен веб-сайт), чтобы получить и отобразить все, что находится на этом URL-адресе.

Хотя API — это не сам сервер, это часть сервера, известная как конечная точка, которая отправляет и получает определенные ответы. API — это способ, с помощью которого различные части программного обеспечения могут взаимодействовать друг с другом (т. е. отправлять и получать данные) путем открытия конечных точек.

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

• Вы только что открыли приложение Instagram? Это стало возможным благодаря вызову API.
• Вы когда-нибудь добавляли событие в свой Календарь Google с другого веб-сайта или электронной почты? Этот сайт использовал API Календаря Google для получения этой конкретной информации с сервера Календаря Google.

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

Расцвет REST

Другой термин, который вы, вероятно, слышали, — это REST API. Это не отличается от традиционного определения API. Тем не менее стоит понять, почему REST API стали такими популярными и что отличает REST API от других.

Вначале API были созданы для удовлетворения требований SOAP (простой протокол доступа к объектам). Но этот метод был немного утомительным и требовал большой пропускной способности для передачи наборов данных. Это также требовало много энергии от разработчиков (например, не из веселья). SOAP использует печально известный тяжелый язык разметки XML для отображения данных. Полезно для обеспечения универсальной совместимости, но это все.

Разработчики искали более легкие и гибкие способы выполнения вызовов API. API-интерфейсы REST (репрезентативная передача состояния) представляют собой альтернативное решение для API-интерфейса SOAP. Они не ограничены конкретным протоколом, хотя должны соответствовать определенным архитектурным стилям (если вам интересно углубиться в это, загляните сюда).

Вместо отображения с разметкой XML сервер использует упрощенный язык JSON (просто текстовые файлы). REST API имеют гораздо меньшую пропускную способность, чем SOAP — обычно это всего лишь URL-адрес — и они, естественно, оптимизированы для общения в Интернете.

Вывод: думайте о REST API как о Мари Кондо данных. Они берут и используют только *именно* то, что им нужно. API-интерфейсы SOAP подобны гаражу вашего соседа, который в настоящее время до краев заполнен туалетной бумагой.

Понимание различных типов API

Независимо от того, какому протоколу или стилю следует API, существует несколько типов API, в том числе:

• Открытые API — эти конечные точки, также известные как общедоступные API, доступны любому разработчику и обычно не налагают никаких ограничений на пользователя. Обычно они принимают пожертвования.
• API- интерфейсы партнеров — это API-интерфейсы, предназначенные для совместного использования, и обычно к ним можно получить доступ только через какую-либо торговую площадку.
• Внутренние API — это внутренние инструменты, которые компании используют, чтобы помочь своим сотрудникам работать более эффективно или предоставить им более безопасный способ обмена данными/информацией.
• Составные API — составные API — это способ консолидации вызовов API, которые связаны между собой, но обычно требуют отдельных вызовов API.

Реальные примеры API

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

Коктейльная БД

Допустим, у вас есть местный винный магазин, и вы хотите разместить рецепты коктейлей на своем веб-сайте. Вы можете рассмотреть возможность использования Cocktail DB API выше. Все эти данные (рецепты коктейлей) уже существуют на чужом сервере и могут быть оценены через API.

Когда пользователь нажимает на рецепты маргариты (возможно, превосходного коктейля), их серверы обнаруживают, что конкретный рецепт отправляет его в JSON, он подхватывается веб-сайтом и анализируется в HTML и CSS для представления в браузере вашего веб-сайта.

OpenWeatherMap

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

Этот API предоставляет как бесплатную, так и премиум-версию в зависимости от того, сколько данных вы хотите отобразить.

API электронной почты SendGrid

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

смс

Twilio SMS API — это еще один REST API, который позволяет добавлять в приложения функции обмена сообщениями. Обмен SMS-сообщениями становится все более популярным способом общения брендов с клиентами, потому что это личное, в режиме реального времени, и эти сообщения читаются с гораздо большей скоростью.

Как использовать API

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

Как начать работу с API

Прочтите документацию. Любой API должен иметь соответствующую документацию, которой вы должны следовать. Он расскажет вам, какие у вас есть зависимости, какой это тип API и как его использовать. Плохая документация должна быть тревожным сигналом для вас и вашего разработчика. Мы очень гордимся превосходной документацией Twilio и SendGrid.

Сгенерируйте API-ключ. Вам нужно сгенерировать ключ API, чтобы начать его использовать. Вот инструкции от Google Maps API:

Примечание . Никогда не делитесь ключами API и убедитесь, что они не видны ни в каком общедоступном коде, который вы размещаете на GitHub.

Начните строить: отправляйте электронную почту бесплатно с помощью SendGrid Email API

Остальное зависит от тебя! Возможности поистине безграничны, когда вы работаете с API. Чтобы узнать обо всех возможностях работы с Twilio API, посетите Twilio Code Exchange.

Если вы заинтересованы в использовании SendGrid Email API для бесплатной отправки электронной почты, ознакомьтесь с ним здесь.