Api как использовать: API для начинающих: Как использовать API? Полное руководство

Содержание

API для начинающих: Как использовать API? Полное руководство

API (App Programming Interface) — это интерфейсная программа, которая помогает взаимодействовать с другим программным обеспечением подобно пользовательскому интерфейсу (UI). Он является основной точкой входа для веб-сайта и приложения, включая интеграцию со сторонними разработчиками, облегчая жизнь разработчикам. Эта статья предназначена для тех, кто собирается использовать API в своих проектах. Давайте посмотрим, что такое API?

API предоставляют приложениям возможность взаимодействовать друг с другом. Например, одно приложение может запросить данные у другого приложения и получить их в ответ. Компонент API (Application Program Interface) может разрешать функции одного приложения, а второе приложение может их использовать. Консорциум Всемирной паутины (W3C) определяет API как «набор определений подпрограмм, протоколов и сервисов для создания программных приложений».

Как научиться интеграции API?

API используются в самых разных приложениях, от небольших проектов, например, школьных, до масштабных глобальных сервисов, таких как Google Maps или Facebook. Например, знаменитая кнопка Tweet в Twitter — это API-сервис, который исполняемый код может вызвать и отправить твит от имени пользователя (хотя в последних версиях это изменилось, и большая часть функциональности стала частью страницы).

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

W3C имеет точку входа в API, где вы можете найти ссылки на инструменты, ресурсы, примеры и многие другие ценные вещи. Если вы работаете под Windows или Linux, у W3C есть онлайн-инструмент для документирования служб API, который позволяет тестировать API. Есть также инструменты на базе HTML5 и приложения, удобные для мобильных устройств. Помимо W3C, несколько хороших ресурсов есть у Google:

Google предоставляет множество API для доступа к информации из своих служб. Одним из таких API является API Google Maps. Этот инструмент — отличный способ узнать об API, поскольку в нем используются HTML и JavaScript, которые должны быть знакомы каждому, кто разрабатывает веб-приложение для бизнеса.

Различные этапы изучения интеграции API включают в себя:

Понять, что делают API
Разберитесь в различных типах API
Узнайте об API W3C и Google API
Определите доступные сервисы, к которым можно получить доступ с помощью API
Интегрировать API для создания рабочей системы или программы с вашим кодом и протестировать API
Изучить и понять инструменты, язык сценариев, языки программирования, фреймворки и стиль проектирования для интеграции вашей системы с существующей посредством интеграции API
Попробуйте реализовать коллекции, необходимые для взаимодействия с сервисом, реализованным через API, и научитесь тестировать коллекции API в своем коде, например, объектную модель JSON или модель A<name>Object и т. д.

Как создать API?

Существует несколько способов создания API. Один из самых простых — использовать онлайн-сервис. Многие онлайн-сервисы позволяют разрабатывать и тестировать интерфейс программирования приложений бесплатно или за небольшую плату. Одним из таких примеров является no-code AppMaster, отличная и очень надежная платформа для создания и реализации API. Спецификация является неотъемлемой частью создания API при его проектировании и документировании. Спецификация расскажет другим разработчикам, как использовать ваш API и что им нужно сделать, чтобы взаимодействовать с ним.

Что мне нужно для начала работы?

Для начала работы с тестовым API вам понадобится несколько предметов:

Доменное имя
Место для размещения кода, например, GitHub или SourceForge
HTTP-сервер, чтобы вы могли запускать свой код локально

На каком языке должен быть написан мой API?

Не существует правил для создания ключа API. Это зависит от ваших потребностей, но некоторые распространенные варианты включают:

PHP
Java
Ruby
Net

В чем преимущество создания API?

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

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

API эндпоинты

API эндпоинты — это методы которые представляют собой некий шлюз, который соединяет серверные приложения со встроенным интерфейсом. Простыми словами, это адрес, на который отправляются сообщения. Эти методы могут включать JSON, XML и другие. Каждый URL должен иметь метод, который запрашивается, например GET или POST.

Использование API эндпоинтов

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

Определите и используйте имя URL эндпоинта
Определите и используйте метод HTTP
Определите тело запроса и его параметры
Определите стратегию аутентификации, если необходимо
Для удобства к каждому эндпоинту прикрепляется дополнительный параметр. Точно так же, как при создании функции в других языках программирования, вы должны включить эндпоинты или эти эндпоинты в свой исходный код, поэтому обязательно объявите свои эндпоинты или эти эндпоинты в заголовочном файле в верхней части вашего исходного кода.

Что такое API эндпоинт?

Эндпоинт — это компонент API
Эндпоинт — это местоположение ресурса
API извлекает ресурсы с помощью URL эндпоинта
Эндпоинт является одним из концов канала связи

Что такое API для начинающих?

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

Пользователи могут использовать API для получения информации от других программ, получения данных и многого другого. Например, в мире iPhone вы можете использовать API, доступный в вашем приложении, для получения данных от другого приложения, например, созданного Facebook, Twitter и т.д., через App Store компании Apple.

Ниже перечислены некоторые из различных типов API:

API на основе XML

Они также известны как API веб-служб и REST API (передача репрезентативного состояния). Единственное различие между API на основе XML и API веб-служб заключается в их синтаксисе. API на основе XML поддерживают все основные веб-браузеры, включая Internet Explorer, Safari, Chrome и Firefox на Windows, OSX и Linux; Internet Explorer 9+ на Windows Phone и другие веб-браузеры. — RESTful API: Это разновидность современного API. Он использует меньшую пропускную способность, чем другие форматы, такие как SOAP. NET.

SOAP APIs

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

Удаленные вызовы процедур (RPC)
Удаленные вызовы процедур используют SOAP поверх HTTP для связи между клиентом и сервером в API-ключе. Это относительно новый способ создания API. Он включает удаленные конечные точки для клиента, чтобы отправлять и получать данные и передавать команды.
Обобщенный язык объектного моделирования (GOML): Это более новый формат для создания API, который не сохраняет детали от предыдущих запросов. Вместо этого метод называется функцией в других языках программирования. Единственный недостаток — в нем нет системы событий, но Apple использовала его для создания «swoosh» в iPhone и службы приложений Camera.

Интеграция с API

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

Прежде чем начать интегрировать API-ключ в свой проект, необходимо сделать две вещи:

Узнайте, как использовать и создавать необходимые модели данных.
Узнайте, как работать со всеми различными типами данных.

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

При проектировании вашей системы необходимо продумать, какая информация требуется и какие отношения существуют между ними.

Ниже приведены несколько примеров:

Создайте онлайн-систему, которая отслеживает содержимое веб-сайта.
На сайте есть несколько статей с названиями и авторами (набор данных).
На сайте есть миниатюры для каждой статьи (набор данных).
Пользователь выбирает статью на главной странице (команда).

Команда проходит через вашу программу и запрашивает конкретную статью из базы данных.

Легко ли освоить API?

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

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

Конечные точки API (эндпоинты) — это важные и ценные методы при интеграции API в проект. При разработке ключа API необходимо продумать различные методы, такие как создание, чтение, обновление и удаление (CRUD), а также параметры. Вы должны описать все эти параметры до начала работы над проектом. Ниже перечислены различные методы, которые вы можете использовать для взаимодействия с конечными точками API (эндпоинтами):

GET

Этот метод используется для получения данных из URL. Он также используется для получения полного содержимого HTML-страницы в API. Например, если вы хотите получить всю информацию об определенном пользователе в API, вы запросите его профиль на сервере. Затем сервер отправит ответ.

POST

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

PUT

Этот метод используется для обновления данных в базе данных. В API, если вы хотите изменить информацию в определенной базе данных, вы будете использовать этот метод. Сервер отправит уведомление об успешном обновлении данных.

DELETE

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

Могу ли я создать свой API?

Да, вы можете создать свой API из широкого выбора доступных API, и создать новый очень просто. Вам нужно загрузить код на GitHub или скачать кроссплатформенный SDK и начать разработку API. Также для создания своего API можно воспользоваться помощью известной платформы AppMaster.

Создание пользовательского типа данных или фильтра также возможно, но не обязательно. Если вы хотите работать с уникальным типом данных или функциональностью фильтра, то вам нужен Identity Provider, который будет предоставлять эту функциональность для ваших клиентов при тестировании API (Application Program Interface).

Обучение отнимает много времени, и без соответствующих инструкций или объяснений потребуется время, чтобы понять предмет. Это точно применимо к разработке API; следовательно, лучше проверить, как другие разработчики разработали свои API. Как только вы ознакомитесь с предметом, то с помощью AppMaster вы сможете приступить к созданию своего приложения прикладного программного интерфейса (API) для вашего проекта. Если вы хотите использовать существующий ключ API, то действуйте. Но если вы хотите создать свой собственный и привести его в соответствие со временем, попробуйте использовать AppMaster для разработки приложения для вашего бизнеса.

С помощью API вы можете создать столько приложений, сколько захотите. Кроме того, вы можете начать программировать на любом языке программирования, который отвечает вашим потребностям. Однако, поскольку API строятся совсем иначе, чем другие типы программ, человек с опытом программирования должен начать изучение процесса с нуля. AppMaster значительно облегчает задачу программирования и помогает создать более надежное и креативное приложение для вашего бизнеса.

Существует множество преимуществ, которые мы можем получить от разработки API-ключа. Начнем с того, что ваше приложение станет более привлекательным для ваших пользователей, поскольку оно сможет предоставлять информацию о ресурсах. Кроме того, вы сможете лучше управлять своими данными, потому что приложение может легко получить к ним доступ в любом месте. Вопросы безопасности, связанные с тестированием API (Application Program Interface), также решаются благодаря отсутствию необходимости передавать конфиденциальные данные по сети. Это гарантирует, что никто не получит доступ к тестовому API (Application Program Interface), что впоследствии может привести к проблемам.

Заключительные мысли

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

Платформа предоставляет все ключевые функциональные возможности для тестирования API и разработки исполнения API. После создания API (прикладного программного интерфейса) вы можете использовать его в качестве отправной точки для создания своих приложений. После этого вы сможете продвигать свои услуги и получать больше клиентов. Посетите AppMaster для получения дополнительной информации о no-code приложениях и разработке API.

API для начинающих: Как использовать API? Полное руководство

Как научиться интеграции API?

Различные этапы изучения интеграции API включают в себя:

Понять, что делают API
Разберитесь в различных типах API
Узнайте об API W3C и Google API
Определите доступные сервисы, к которым можно получить доступ с помощью API
Интегрировать API для создания рабочей системы или программы с вашим кодом и протестировать API
Изучить и понять инструменты, язык сценариев, языки программирования, фреймворки и стиль проектирования для интеграции вашей системы с существующей посредством интеграции API
Попробуйте реализовать коллекции, необходимые для взаимодействия с сервисом, реализованным через API, и научитесь тестировать коллекции API в своем коде, например, объектную модель JSON или модель A<name>Object и т.д.

Как создать API?

Что мне нужно для начала работы?

Для начала работы с тестовым API вам понадобится несколько предметов:

Доменное имя
Место для размещения кода, например, GitHub или SourceForge
HTTP-сервер, чтобы вы могли запускать свой код локально

На каком языке должен быть написан мой API?

PHP
Java
Ruby
Net

В чем преимущество создания API?

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

API эндпоинты

Использование API эндпоинтов

Определите и используйте имя URL эндпоинта
Определите и используйте метод HTTP
Определите тело запроса и его параметры
Определите стратегию аутентификации, если необходимо
Для удобства к каждому эндпоинту прикрепляется дополнительный параметр. Точно так же, как при создании функции в других языках программирования, вы должны включить эндпоинты или эти эндпоинты в свой исходный код, поэтому обязательно объявите свои эндпоинты или эти эндпоинты в заголовочном файле в верхней части вашего исходного кода.

Что такое API эндпоинт?

Эндпоинт — это компонент API
Эндпоинт — это местоположение ресурса
API извлекает ресурсы с помощью URL эндпоинта
Эндпоинт является одним из концов канала связи

Что такое API для начинающих?

Ниже перечислены некоторые из различных типов API:

API на основе XML

SOAP APIs

Удаленные вызовы процедур (RPC)
Удаленные вызовы процедур используют SOAP поверх HTTP для связи между клиентом и сервером в API-ключе. Это относительно новый способ создания API. Он включает удаленные конечные точки для клиента, чтобы отправлять и получать данные и передавать команды.
Обобщенный язык объектного моделирования (GOML): Это более новый формат для создания API, который не сохраняет детали от предыдущих запросов. Вместо этого метод называется функцией в других языках программирования. Единственный недостаток — в нем нет системы событий, но Apple использовала его для создания «swoosh» в iPhone и службы приложений Camera.

Интеграция с API

Прежде чем начать интегрировать API-ключ в свой проект, необходимо сделать две вещи:

Узнайте, как использовать и создавать необходимые модели данных.
Узнайте, как работать со всеми различными типами данных.

Ниже приведены несколько примеров:

Создайте онлайн-систему, которая отслеживает содержимое веб-сайта.
На сайте есть несколько статей с названиями и авторами (набор данных).
На сайте есть миниатюры для каждой статьи (набор данных).
Пользователь выбирает статью на главной странице (команда).

Команда проходит через вашу программу и запрашивает конкретную статью из базы данных.

Легко ли освоить API?

GET

POST

PUT

DELETE

Могу ли я создать свой API?

Заключительные мысли

Полное руководство по доступу и использованию API

Возможно, вы не знаете, что делает API. Вы можете не знать, что это означает. Но повседневные API-интерфейсы работают за кулисами, чтобы предоставить вам более богатые цифровые возможности. Билет в кино, который вы купили онлайн, рецепт блогера, которым вы поделились на Facebook, и дешевый рейс, который вы забронировали на Expedia, — все это благодаря API.

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

Что такое API?
Как работают API?
Типы API
Как использовать API
REST API
Примеры API

Что такое API?

API, сокращенно от Application Programming Interface, представляет собой интерфейс между программами. API-интерфейсы обеспечивают безопасный и стандартизированный способ взаимодействия приложений друг с другом и предоставления запрашиваемой информации или функций без вмешательства пользователя.

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

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

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

После ввода почтового индекса и выбора даты вы нажимаете кнопку «Перейти», и, вуаля, через несколько секунд появляется список сеансов в ближайших кинотеатрах. Вот как это выглядит для конечного пользователя.

Источник изображения

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

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

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

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

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

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

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

Вызовы API

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

Методы запроса

Большинство клиентов хотят, чтобы сервер выполнял основные функции. Эти запросы могут быть записаны как URL-адреса, чтобы связь между клиентом и сервером диктовалась правилами протокола передачи гипертекста (HTTP). Четыре основных метода запроса к серверу:

GET: получение ресурса
POST: для создания нового ресурса
PUT: для редактирования или обновления существующего ресурса
УДАЛИТЬ: Чтобы удалить ресурс

Все еще запутались? Попробуем провести аналогию. То, как работают API, часто сравнивают с заказом еды в ресторане, где вы, посетитель, представляете клиента, официант представляет API, а шеф-повар представляет сервер. Вы просматриваете меню, выбираете понравившееся блюдо и делаете заказ официанту. Официант приносит вашу просьбу шеф-повару. Шеф-повар выполняет на нем. Затем официант приносит вам еду, и вы наслаждаетесь ею еще больше, потому что вам не пришлось готовить ее самостоятельно.

Источник изображения

Но, допустим, в ресторане приходит слишком много гостей, и им не хватает места. Допустим, так будет продолжаться по мере роста популярности ресторана. Что тогда? Вот тут-то и появляются API-ключи.

Что такое API-ключ?

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

Хотя этот метод не так безопасен, как токены аутентификации, он имеет некоторые преимущества по сравнению с обычной аутентификацией, для которой требуется только имя пользователя и пароль.

Ограничивая доступ только тем, у кого есть ключи, компания может контролировать количество обращений к своему API и гарантировать, что только определенная доверенная группа клиентов может получить доступ к ресурсам своего сервера.

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

Для чего используются API?

Лучше спросить, для чего используются API

, а не . Хотите встроить фотографии из Instagram в свое приложение для электронной коммерции? Для этого есть API. Хотите предоставить мгновенный доступ к тысячам отелей в своем блоге о путешествиях? Для этого есть API. Хотите интегрировать переводчик Йоды на свой фанфик-сайт «Звездные войны »? Если вы можете в это поверить, для этого есть API.

Вообще говоря, бизнес-приложения API включают:

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

Интеграция приложений: Когда два цифровых приложения работают вместе, например, HubSpot и Gmail, скорее всего, задействован API.
Встроенное содержимое: для встраивания части содержимого, которое не размещено той же компанией, что и сам веб-сайт, например, видео YouTube или стороннего сценария, такого как Google Analytics, владельцу встроенного содержимого отправляется запрос на получение это.
Внутренние системы: API предназначены не только для внешнего обмена данными. Компании часто делят свою программную инфраструктуру на более мелкие компоненты, которые взаимодействуют друг с другом через API, как в архитектуре микросервисов.

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

Примеры API

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

API-интерфейсы Twitter

Если вы работаете в бренде, который любит Twitter, вы можете использовать API-интерфейсы платформы социальных сетей для привлечения пользователей на свой сайт.

У Твиттера есть целая платформа, предлагающая API, которые позволяют вам копаться в огромном архиве Твиттера. Вы можете использовать API Twitter, чтобы находить старые твиты, встраивать твиты и временные шкалы на свой веб-сайт или в приложение, программно создавать рекламные кампании и управлять ими, фильтровать и транслировать твиты в режиме реального времени, предоставлять персонализированное обслуживание клиентов с помощью прямых сообщений, подписываться на действия в реальном времени. более 15 учетных записей через вебхуки и многое другое.

Существует также множество технических ресурсов и инструментов, которые помогут вам использовать весь потенциал глобальной коммуникационной сети.

API-интерфейсы Instagram

Платформа Instagram предлагает ряд API-интерфейсов, которые помогут вашему бизнесу с публикацией контента, метриками, анализом и многим другим.

Одним из возможных вариантов использования является встраивание созданных пользователями фотографий из Instagram в ваше приложение. Пользовательский контент, иногда сокращаемый до UGC, является сильной формой социального доказательства, которое может побудить потенциальных клиентов совершить конверсию.

Разработчики подключаются к этой платформе для создания приложений и служб, ориентированных на три группы: отдельные лица, желающие поделиться своим контентом со сторонними приложениями; бренды и рекламодатели должны понимать и управлять своей аудиторией и правами на СМИ; и вещательные компании и издатели, желающие открыть для себя контент и получить цифровые права на медиа или поделиться им с надлежащим указанием авторства.

API YouTube

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

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

API-интерфейсы HubSpot

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

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

Веб-API Spotify

Если вы работаете в музыкальной индустрии, вы можете использовать веб-API Spotify для добавления функций музыкального проигрывателя на свой веб-сайт или в приложение.

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

Функциональность почти идентична той, что вы найдете на родной платформе Spotify. Например, с помощью Browse API ваши пользователи могут получить доступ к жанрам, категориям, новым выпускам и рекомендациям плейлистов. Spotify также предлагает API-интерфейсы Episodes, Follow, Library и Playlists.

Застрял? Spotify опубликовал список примеров приложений, чтобы вы могли увидеть, как их API использовались в прошлом.

API-интерфейсы Google Maps

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

Платформа Google имеет обширную библиотеку API с неограниченным количеством применений. Хотите разрешить пользователям запрашивать маршруты? Как насчет включения Places на ваш сайт? Для вас даже есть API, если вы создаете приложение для совместного использования. Google разделил API по использованию и платформе (Интернет, iOS или Android), поэтому обязательно выберите правильный для своего проекта.

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

API-интерфейсы PayPal

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

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

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

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

Типы API

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

Частные API: Эти API доступны только внутренней команде компании для повышения производительности и прозрачности. Разработчики, работающие в компании, могут использовать эти API по мере необходимости, а сторонние разработчики — нет.

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

Составные API: Эти API позволяют объединять вызовы или запросы для получения единого ответа с разных серверов. Если вам нужны данные из разных приложений, вы должны использовать составной API. Или вместо того, чтобы делать пять отдельных вызовов API подряд, вы можете сделать один, используя составной API.

Более подробное объяснение см. в нашем руководстве по типам API.

Зачем использовать API?

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

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

Преимущества для пользователей API

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

Производительность

Многие компании используют собственные API. Почему? Использование API внутри компании позволяет персоналу оптимизировать операции, развивать сотрудничество и повышать прозрачность в компании. Основатель и генеральный директор Amazon Джефф Безос осознал огромный потенциал внутренних API-интерфейсов еще в 2002 году, когда отправил электронное письмо, в котором рекомендовал каждой команде в будущем общаться через API. Следуя так называемому «мандату Безоса», разработчики создавали или превращали свои хорошо разработанные программные компоненты в API-интерфейсы, создавая в результате согласованные и хорошо управляемые способы обмена данными и возможностями внутри компании.

Удовлетворенность пользователей

Компании хотят предоставить своим пользователям наилучшие возможности. Редко один продукт может удовлетворить и предвосхитить все потребности и ожидания. Вот почему они используют API для расширения функциональности своих продуктов. Например, OpenTable использует Maps JavaScript API для встраивания интерактивной карты на свой сайт, что позволяет пользователям проложить маршрут от дома до близлежащих ресторанов всего за несколько кликов. Если вы не знакомы с этим сайтом, посмотрите на этот снимок экрана, на котором показан обзор стейк-хауса в Индиане.

Источник изображения

Инновации

Позволяя разработчикам — сторонним или внутренним сотрудникам — повторно использовать программные компоненты, API-интерфейсы позволяют им сосредоточиться на разработке новых решений, а не на повторении уже выполненной работы. Вернемся к примеру выше. Без Google Maps API разработчикам OpenTable пришлось бы тратить свое время и ресурсы на создание собственной карты и предоставление картографических данных в реальном времени для включения этой функции на свой сайт. Что еще хуже, независимо от того, сколько времени они потратили, было бы почти невозможно сделать его таким же подробным или надежным, как существующее решение Google. Таким образом, вместо того, чтобы тратить время на попытки заново изобрести велосипед, API-интерфейсы позволяют разработчикам сосредоточиться на создании новых инструментов и функций, которые приносят больше пользы пользователям.

Преимущества для поставщиков API

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

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

Доход

Самый простой ответ — деньги. Google, Yelp, Facebook и тысячи других компаний публикуют свои API и монетизируют их, чтобы они стали дополнительным источником дохода. Фактически, в некоторых компаниях API являются основным источником дохода. Согласно недавнему отчету MuleSoft Inc., 35% современных технологических лидеров получают более четверти доходов своих организаций непосредственно за счет API.

Масштаб

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

Amazon Web Services (AWS) — один из самых ярких примеров. Эта платформа, которая, по сути, позволяет любой компании или разработчику запускать свои приложения поверх платформы технологической инфраструктуры Amazon через API, используется миллионами клиентов по всему миру, и ей приписывают превращение Amazon из книжного интернет-магазина в глобального цифрового гиганта.

Еще больше инноваций

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

Однако чаще всего отношения между потребителями и поставщиками API носят гораздо более взаимный характер. Возможно, вы помните, что на заре существования Twitter его пользовательский интерфейс был немного неуклюжим. Затем появилось независимое в то время приложение TweetDeck, которое создало улучшенный пользовательский интерфейс поверх платформы Twitter, используя общедоступный API, чтобы все пользователи могли лучше работать с Twitter. Это называется беспроигрышный вариант, друзья мои.

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

Итак, вы готовы попытать счастья с API. Что теперь? Прежде чем внедрять собственный API в своей компании, имеет смысл использовать чужие API. Давайте рассмотрим основы того, как начать использовать API.

1. Выберите API.

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

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

2. Получите ключ API.

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

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

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

3. Просмотрите документацию API.

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

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

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

4.

Напишите запрос на конечную точку.

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

На этом этапе на помощь могут прийти онлайн-уроки. Например, в этом видео на YouTube объясняется, как использовать API для извлечения данных о местоположении из Google Maps, а затем использовать эти координаты для поиска ближайших фотографий в Instagram.

5. Подключите свое приложение.

Теперь, когда вы понимаете, как выполнять запросы к выбранному вами API, вы можете синхронизировать с ним свое приложение. Вам, как маркетологу, не нужно беспокоиться об этом этапе интеграции API. Это работа разработчика, который будет использовать один или несколько языков, таких как Python, Java, JavaScript (и NodeJS), PHP и другие.

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

API-интерфейсы REST

API-интерфейсы REST соответствуют ограничениям стиля архитектуры программного обеспечения, называемого «Передача репрезентативного состояния», что делает API-интерфейсы относительно простыми в использовании и обнаружении. REST делает данные и функции доступными в виде ресурсов, которые представлены уникальными URL-адресами. Чтобы запросить ресурс через REST API, например Open Weather Map API, вам просто нужно указать его URL-адрес.

В типичном REST API ресурсу будут назначены два шаблона URL: множественное число (для ссылки на все ресурсы) и единственное число (для указания одного ресурса). Их также называют конечными точками. Можете ли вы догадаться, почему? Потому что они идут в конце URL.

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

Клиент должен будет включить правильный HTTP-глагол (GET, POST, PUT, DELETE) в свой запрос, чтобы сообщить серверу, какое действие предпринять.

Клиент и сервер могут использовать три формата данных для передачи этой информации туда и обратно:

HTML (язык гипертекстовой разметки)
XML (расширяемый язык разметки)
JSON (обозначение объекта JavaScript)

Пример REST API

WordPress имеет REST API, который позволяет разработчикам удаленно создавать, читать и обновлять содержимое WordPress, передавая объекты JSON туда и обратно между клиентами и серверами. Другими словами, позволяя разработчикам легко структурировать способ передачи данных на сервер и из него, они могут тратить меньше времени на доступ к нужным им данным и больше времени на улучшение взаимодействия с пользователем.

REST против SOAP

REST обычно сопоставляется с протоколом простого доступа к объектам (SOAP), еще одним способом создания приложений, работающих через HTTP. REST считается более простой альтернативой SOAP, так как требует написания меньшего количества кода для выполнения задач и имеет менее жесткую структуру и логику, чем SOAP. Еще одна причина, по которой люди любят REST: он предоставляет множество соглашений, но оставляет множество решений на усмотрение человека, разрабатывающего API.

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

Будущее цифровой экономики

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

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

Этот пост был первоначально опубликован в октябре 2019 года и обновлен для полноты информации.

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

Основные выводы

API полезен для получения определенной информации из другой программы.
Изучение того, как использовать API, может занять некоторое время, но преимущества делают это стоящим занятием.

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

В этой статье…

Начать использовать API

Многие API-интерфейсы, с которыми вы столкнетесь в своей повседневной деловой жизни, предназначены для перемещения информации из одной программы в аналогичные поля формы в другой программе. Изучение того, как эффективно использовать API, может полностью изменить работу вашего бизнеса. Это особенно полезно, когда вы пытаетесь поделиться информацией, которую в противном случае вам пришлось бы вводить неоднократно, например, обмен лидами между вашей платформой автоматизации маркетинга и вашей CRM.

Самый простой способ начать использовать API — найти HTTP-клиент в Интернете, например REST-Client, Postman или Paw. Эти готовые к использованию инструменты помогут вам структурировать ваши запросы на доступ к существующим API. Вам все равно нужно будет знать некоторые синтаксис, изложенный в документации, но требуется очень мало знаний в области кодирования. Если у вас нет уже существующей базы знаний по кодированию, это, вероятно, облегчение.

Следующим лучшим способом извлечения данных из API является создание URL-адреса из существующей документации. В этом видео на YouTube объясняется, как получить данные о местоположении из Google Maps через API, а затем использовать эти координаты для поиска ближайших фотографий в Instagram.

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

Пример URL из документации — запрос погоды для определенного города:

api. openweathermap.org/data/2.5/weather?q={название города}

Введите в браузере:

api.openweathermap.org/data/2.5/weather?q=Nashville,TN&APIID={numberslettersnumbersletters}

Обязательно замените «numberslettersnumbersletters» своим ключом API, иначе вы получите код состояния 401, говорящий о том, что ваш ключ API недействителен. Без действительного ключа ваша аутентификация завершится неудачно.

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

Зачем вам использовать API?

Компьютеры многое упрощают, особенно задачи, связанные со сбором и сортировкой огромного количества данных. Прошли те времена, когда приходилось искать локально размещенные электронные таблицы или даже копаться в картотеках в поисках информации, к которой вы хотите получить доступ. Теперь есть базы данных. Если компьютеры все упрощают, быстрый запрос должен дать все, что вам нужно, верно?

Если ваша компания использует систему управления взаимоотношениями с клиентами (CRM), такую как Salesforce, данные, которые вы ищете, вероятно, находятся где-то в их облачном хранилище. Чтобы получить к нему доступ, вам, вероятно, потребуется использовать API.

API

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

Хотя использование API может показаться ненужной дополнительной работой, они предназначены для повышения информационной безопасности и упрощения доступа к данным, необходимым для принятия взвешенных бизнес-решений. К сожалению, простота использования относительна. Если вы не ИТ-специалист, перспектива научиться использовать API может поначалу пугать.

Лучшие инструменты управления API

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

1 Мулсофт

Посетите веб-сайт

Используйте платформу Mulesoft Anypoint для быстрого проектирования, тестирования и публикации продуктов API. Управляйте API, отслеживайте и анализируйте использование, контролируйте доступ и защищайте конфиденциальные данные с помощью политик безопасности. С Anypoint API Community Manager превратите порталы в цифровой опыт, который превратит разработчиков в евангелистов, предоставляя самостоятельную документацию по API, форумы, поддержку и персонализированные ресурсы, необходимые разработчикам для достижения успеха.

Узнайте больше о Mulesoft

2 Апигей

Посетите веб-сайт

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

Узнайте больше о Apigee

3 Программное обеспечение АГ

Посетите веб-сайт

WebMethods API Management от Software AG позволяет вам воспользоваться преимуществами экономики API, управляя всем процессом планирования, проектирования, разработки и безопасного предоставления ваших API внешним разработчикам, партнерам и потребителям. Это решение Software AG предоставляет сквозную цепочку инструментов, позволяющую использовать ваши текущие инвестиции в SOA для новых инициатив API, чтобы получить больше от ваших текущих активов, экономя время и снижая затраты на разработку и обучение.

Узнайте больше о программном обеспечении AG

4 IBM API Connect

Посетите веб-сайт

Защитите всю свою экосистему API в нескольких облаках и управляйте ею, в том числе активизируя усилия по социализации и монетизации, с помощью ведущего в отрасли решения IBM API Connect. IBM API Connect® — это полная, интуитивно понятная и масштабируемая платформа API, которая позволяет создавать, предоставлять, управлять и монетизировать API в облаках. Это означает, что вы и ваши клиенты можете использовать цифровые приложения и стимулировать инновации. Повысьте производительность разработчиков API с помощью упрощенных методов и встроенного набора инструментов.

Узнайте больше о IBM API Connect

5 Конг

Посетите веб-сайт

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

Узнайте больше о Kong

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

Возможно, вы этого не осознаете, но, возможно, вы уже регулярно используете API. Когда в последний раз веб-сайт предоставлял вам возможность войти в систему с помощью вашей учетной записи Google или Facebook? Как насчет возможности оплаты через Paypal? Вы недавно использовали сайт бронирования путешествий? Вы смотрели сегодня утром приложение погоды на своем телефоне?

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

Пользователь: человек, который делает запрос
Клиент: компьютер, который отправляет запрос на сервер
Сервер: компьютер, который отвечает на запрос

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

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

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

API можно разделить на основе их архитектуры или того, как они построены. Давайте рассмотрим два наиболее распространенных типа архитектуры API.

API-интерфейсы SOAP

SOAP означает простой протокол доступа к объектам. В этом архитектурном стиле клиент и сервер взаимодействуют друг с другом с помощью XML. Этот тип API популярен благодаря своей жесткой структуре и независимости от какого-либо конкретного языка программирования. Хотя они менее распространены, чем когда-то, многие организации по-прежнему используют API-интерфейсы SOAP.

Примеры API-интерфейсов SOAP включают…

Salesforce SOAP API
Workday SOAP API
Sabre SOAP API

REST API

Аббревиатура REST означает передачу репрезентативного состояния. С REST API клиент и сервер могут взаимодействовать друг с другом с помощью XML, но они не ограничены этим конкретным языком. Этот тип также является более гибким. Думайте об этом как о руководстве по стилю, а не как о строгом стандарте.

Если вы занимаетесь исследованием API, вы, возможно, встречали термин RESTful API, часто взаимозаменяемый с REST API. Различия между ними небольшие, но важные. RESTful API обладает всеми функциями архитектуры REST, но немного отличается тем, что имеет транспортный протокол и делает кэшированную информацию доступной в любое время, а не вытесняет ее, если она не используется. Уникальные возможности RESTful API, как правило, делают его более гибким, но менее безопасным.

Примеры REST AP включают:

REST API Amazon Product Advertising
REST API Flickr
REST API YouTube

Что делает API?

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

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

GET: запрашивает данные с сервера
POST: отправляет изменения с клиента на сервер; думайте о POST-запросе как о добавлении информации на сервер, например, о создании новой записи
PUT: пересматривает или добавляет существующую информацию
DELETE: удаляет существующую информацию

Когда вы объединяете конечные точки с этими действиями, также называемыми глаголами HTTP, вы можете искать или обновлять любую доступную информацию через API. Вам нужно будет проверить документацию API, чтобы узнать, как кодировать эти действия, поскольку все они разные.

вызовов API

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

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

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

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

Коды состояния

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

Обычно код состояния начинается с 2 или 4. Если он начинается с 2, скорее всего, ваш запрос выполнен успешно. 4 обычно означает, что что-то пошло не так.

Узнайте больше об API

API полезен для извлечения конкретной информации из другой программы. Если вы знаете, как читать документацию и писать запросы, вы можете получить много отличных данных. Однако разбор его может показаться ошеломляющим. Именно здесь в дело вступают разработчики. Они могут создавать программы, которые отображают данные непосредственно в приложении или окне браузера в удобном для использования формате.

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

Что такое API?
Вызовы API: что это такое и как их сделать за 5 простых шагов
Как использовать API с JavaScript (Полное руководство для начинающих)
Что такое интеграция API? (для нетехнических специалистов)
Курсы API LinkedInLearning
Учебники W3Schools по XML и JSON
Концепции и примеры API REST
Почему API так важны?

Хотите подключить свои программы, но нет времени на сборку клиента? Существует множество компаний, которые подключат существующие API или создадут для вас пользовательские подключения.