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

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

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

Что такое ?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Типы

1. Частные .
2. Партнерские .
3. Публичные .

Эти имена интуитивно понятны, поэтому мы кратко коснемся каждого типа ниже.

Частные

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

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

Партнерские

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

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

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

Публичные

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

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

Преимущества

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

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

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

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

Продуктивность

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

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

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

Инновации

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

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

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

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

Доход

Простой ответ – деньги. , , и тысячи других компаний делают свои общедоступными и монетизируют их, чтобы они стали дополнительными источниками дохода. Фактически, в некоторых компаниях являются основным источником дохода. Согласно недавнему , 35 процентов сегодняшних технологических лидеров генерируют более четверти дохода своих организаций в результате использования .

Шкала

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

Инновации

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

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

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

Выбор

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

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

Просмотр документации

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

Написание запроса

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

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

Допустим, вы хотите запросить погоду для конкретного города с помощью Open Weather Map. Просматривая документацию, вы найдете этот пример URL: api.openweathermap.org/data/2.5/weather?q={city name}. Сладкий! Теперь все, что вам нужно сделать, это скопировать и вставить этот URL-адрес в браузер, ввести название города, о котором вы хотите знать, и указать свой ключ . Если вы хотите знать погоду в Нэшвилле, ваш URL-адрес будет выглядеть так: api.openweathermap.org/data/2.5/weather?q=Nashville,TN&ID={numberslettersnumbersletters}.

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

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

REST

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

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

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

Клиент и сервер могут использовать разные форматы данных для передачи этой информации туда и обратно. JSON, аббревиатура от JavaScript Object Notation, является излюбленным форматом данных, используемым для REST , поскольку он считается легким и удобочитаемым.

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

ОТДЫХ против мыла

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

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

Примеры

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

Twitter

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

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

Instagram

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

YouTube

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

HubSpot

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

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

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

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

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

записи:

• статьи о wordpress, web