Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info
Apigee Edge — это платформа для разработки и управления API. Используя прокси-сервер для взаимодействия с сервисами, Edge предоставляет абстракцию или фасад для API ваших бэкэнд-сервисов, обеспечивая безопасность, ограничение скорости запросов, квоты, аналитику и многое другое.
Например, вы можете посмотреть вебинар о том, как Walgreens использует API и Apigee Edge для создания развитой экосистемы приложений, охватывающей печать фотографий, выписку рецептов и другие предоставляемые ими услуги.
Цифровое ускорение
В этом видео вы получите краткое представление о том, как Apigee помогает вам перейти к цифровому бизнесу.
Выбор между управлением сервисами и управлением API.
Это видео поможет вам понять важные различия между управлением сервисами и управлением API в бизнесе.
Предоставление доступа к вашим услугам в интернете.
Сегодня компании стремятся предоставлять свои серверные сервисы в интернете, чтобы эти сервисы могли использоваться приложениями, работающими на мобильных устройствах и настольных компьютерах. Компания может захотеть предоставить сервисы, обеспечивающие информацию о ценах и наличии товаров, услуги по продажам и оформлению заказов, отслеживанию заказов и любые другие услуги, необходимые клиентским приложениям.
Компании часто предоставляют сервисы в виде набора HTTP-конечных точек. Разработчики клиентских приложений затем отправляют HTTP-запросы к этим конечным точкам. В зависимости от конечной точки, сервис может возвращать данные в формате XML или JSON обратно в клиентское приложение.
Клиентские приложения, использующие эти сервисы, могут быть реализованы как автономные приложения для мобильных устройств или планшетов, как HTML5-приложения, работающие в браузере, или как любой другой тип приложения, способного отправлять запросы к HTTP-конечной точке и получать данные ответа. Эти приложения могут быть разработаны и выпущены той же компанией, которая предоставила доступ к сервисам, или сторонними разработчиками приложений, использующими общедоступные сервисы.
На следующем изображении показана модель такого типа:
Поскольку поставщики услуг предоставляют свои услуги через Интернет, они должны убедиться, что предприняли все необходимые шаги для обеспечения безопасности и защиты своих услуг от несанкционированного доступа. Поставщику услуг следует учитывать следующее:
- Безопасность: Как вы будете контролировать доступ к своим сервисам, чтобы предотвратить несанкционированный доступ?
- Совместимость: Будут ли ваши сервисы работать на разных платформах и устройствах?
- Измеримость: Как можно отслеживать доступность ваших сервисов, чтобы убедиться в их работоспособности?
- Монетизация: Как отслеживать и выставлять счета клиентам за доступ к вашим услугам?
- И многие другие соображения.
После выпуска клиентского приложения, обращающегося к каким-либо сервисам, поставщик услуг обязан обеспечить бесперебойную работу этих сервисов с течением времени, по мере их добавления, изменения или удаления. Поставщик услуг также должен иметь возможность информировать разработчиков приложений о любых изменениях в сервисах, чтобы гарантировать синхронизацию клиентских приложений с этими сервисами.
Разработчики клиентских приложений сталкиваются с трудностями при попытке использовать сервисы от разных поставщиков. Сегодня существует множество технологий, которые поставщик услуг может использовать для предоставления своих сервисов. Одно и то же клиентское приложение может использовать один механизм для получения сервиса от одного поставщика и другой механизм для получения сервиса от другого поставщика. Разработчики приложений могут даже столкнуться с ситуацией, когда им приходится использовать разные механизмы для получения сервисов от одного и того же поставщика.
Обеспечьте доступность услуг через Apigee Edge.
Apigee Edge позволяет обеспечить безопасный доступ к вашим сервисам с помощью четко определенного API, который является согласованным для всех ваших сервисов, независимо от их реализации. Согласованный API:
- Это упрощает разработчикам приложений использование ваших сервисов.
- Позволяет изменять реализацию серверной части без влияния на публичный API.
- Позволяет использовать преимущества аналитики, монетизации, портала для разработчиков и других функций, встроенных в Edge.
На следующем изображении показана архитектура, в которой Edge обрабатывает запросы от клиентских приложений к вашим бэкэнд-сервисам:
Вместо того чтобы разработчики приложений напрямую использовали ваши сервисы, они обращаются к API-прокси, созданному в Edge. API-прокси функционирует как сопоставление общедоступной HTTP-конечной точки с вашим бэкэнд-сервисом. Создав API-прокси, вы позволяете Edge обрабатывать задачи безопасности и авторизации, необходимые для защиты ваших сервисов, а также для анализа, мониторинга и монетизации этих сервисов.
Поскольку разработчики приложений отправляют HTTP-запросы к API-прокси, а не напрямую к вашим сервисам, им не нужно знать ничего о реализации ваших сервисов. Все, что нужно знать разработчику, это:
- URL-адрес конечной точки прокси-сервера API.
- Любые параметры запроса, заголовки или параметры тела запроса, передаваемые в запросе.
- Все необходимые учетные данные для аутентификации и авторизации.
- Формат ответа, включая формат данных ответа, например, XML или JSON.
API-прокси изолирует разработчика приложения от вашей серверной части. Поэтому вы можете свободно изменять реализацию сервиса, если публичный API остается неизменным. Поддерживая согласованный API на стороне клиента, существующие клиентские приложения будут продолжать работать независимо от изменений на стороне бэкэнда.
Вы можете использовать политики на API-прокси для добавления функциональности к сервису без внесения каких-либо изменений в бэкэнд-сервис. Например, вы можете добавить политики на свой прокси для выполнения преобразований и фильтрации данных, повышения безопасности, выполнения условной логики или пользовательского кода, а также для выполнения многих других действий. Важно помнить, что политики реализуются на Edge, а не на вашем бэкэнд-сервере.
Для получения более подробной информации см. раздел «Понимание API и API-прокси» .
Создайте API-продукт
API-прокси — это HTTP-конечная точка в Apigee Edge, которую разработчики используют для доступа к вашим бэкэнд-сервисам. Хотя это и возможно, обычно отдельные API-прокси не предоставляются. Вместо этого один или несколько API-прокси объединяются в API-продукт.
API-продукт представляет собой набор API-прокси в сочетании с тарифным планом. Этот тарифный план может устанавливать ограничения доступа к API-прокси, обеспечивать безопасность, разрешать мониторинг и аналитику, а также предоставлять дополнительные функции. API-продукты также являются центральным механизмом, который Edge использует для авторизации и контроля доступа к вашим API.
При создании API-продуктов у вас есть большая гибкость. Например, несколько API-продуктов могут использовать один и тот же API-прокси. На следующем рисунке показаны три API-продукта. Обратите внимание, что все продукты предоставляют доступ к API-прокси 3, но только продукт A предоставляет доступ к API-прокси 1.
Для каждого API-продукта можно установить разные параметры. Например, вы можете предложить один API-продукт с низким лимитом доступа, скажем, 1000 запросов в день, по выгодной цене. Затем вы выпустите другой API-продукт, предоставляющий доступ к тому же API-прокси, но с гораздо более высоким лимитом доступа, по более высокой цене. Или вы можете создать бесплатный API-продукт, разрешающий доступ к вашим сервисам только для чтения, а затем продать API-продукт тем же API-прокси, разрешающий доступ для чтения и записи.
Для получения дополнительной информации см. раздел «Управление продуктами API» .
Разрешите клиентскому приложению доступ к вашему API-продукту.
Когда разработчики приложений решают получить доступ к вашим сервисам, они должны сначала зарегистрировать свое клиентское приложение в вашем API-продукте.
После регистрации разработчик приложения получает ключ API, который он должен указывать в каждом запросе к прокси-серверу API, входящему в состав API-продукта. Этот ключ проходит аутентификацию, и если аутентификация прошла успешно, запрос получает доступ к вашему бэкэнд-сервису.
В любой момент вы можете отозвать ключ, чтобы клиентское приложение больше не имело доступа к вашим сервисам. Или вы можете установить ограничение по времени для ключа, чтобы разработчик должен был обновить ключ через определенное время.
Вы сами решаете, как обрабатывать запросы на регистрацию от разработчиков для доступа к вашим API-продуктам. Используя Apigee Edge Developer Services, вы можете автоматизировать процесс регистрации или использовать ручной процесс для управления доступом.
Создавайте API-продукты и предоставляйте к ним доступ разработчикам.
- Создайте один или несколько API-прокси, которые сопоставляют общедоступные URL-адреса с вашими внутренними сервисами.
- Создайте API-продукт, который будет включать в себя ваши API-прокси.
- Разверните свои API-прокси и API-продукт.
- Сообщите своим разработчикам о доступности API-продукта.
Как только разработчики приложений узнают о доступности вашего API-продукта, они:
- Зарегистрируйте их клиентские приложения в вашем API-продукте.
- Получите ключ API для продукта API.
- Отправляйте запросы к своим сервисам через API-прокси (которые входят в состав API-продукта) и передавайте API-ключ с каждым запросом.
Компоненты Apigee Edge
Apigee Edge включает в себя среду выполнения API, мониторинг и аналитику, а также сервисы для разработчиков, которые в совокупности обеспечивают комплексную инфраструктуру для создания, обеспечения безопасности, управления и эксплуатации API.
На следующем рисунке показаны сервисы Edge:
Среда выполнения Edge API
Сервисы Apigee Edge API предназначены для создания и использования API, независимо от того, создаете ли вы API-прокси в качестве поставщика услуг или используете API, SDK и другие удобные сервисы в качестве разработчика приложений.
Сервер управления API предоставляет инструменты для добавления и настройки ваших API-прокси, настройки API-продуктов, а также управления разработчиками приложений и клиентскими приложениями. Он снимает с ваших бэкэнд-сервисов множество распространенных задач управления. При добавлении API-прокси вы можете применять к нему политики для повышения безопасности, ограничения скорости запросов, посредничества, кэширования и т. д. Вы также можете настроить поведение вашего API-прокси, используя пользовательские скрипты, выполняя вызовы к сторонним API и сервисам и т. д. См. раздел «Понимание API и API-прокси» для получения дополнительной информации.
Если вы разработчик Node.js, вы можете легко добавлять свои модули Node.js в Edge для создания API и API-мэшапов, одновременно используя преимущества, которые предоставляет Edge, от преобразования сообщений до безопасности и аналитики.
Мониторинг и аналитика на периферии сети
Apigee Edge API Analytics предоставляет мощные инструменты для отслеживания краткосрочных и долгосрочных тенденций использования ваших API. Вы можете сегментировать свою аудиторию по ведущим разработчикам и приложениям, анализировать использование API по различным методам, чтобы знать, куда инвестировать, и создавать пользовательские отчеты на основе информации бизнес- или операционного уровня.
При передаче данных через Edge по умолчанию собирается несколько типов информации, включая URL, IP-адрес, идентификатор пользователя для информации о вызовах API, задержку, данные об ошибках и так далее. Вы можете создавать политики для добавления другой информации, такой как заголовки, параметры запроса и части запроса или ответа, извлеченные из XML или JSON. Эта информация собирается асинхронно от фактического потока запроса/ответа и, следовательно, не влияет на производительность API.
Интерфейс управления позволяет просматривать множество метрик и параметров в браузере, как показано на следующем рисунке:
Однако вы также можете получить доступ к сервису аналитики и управлять им через интерфейс командной строки или с помощью RESTful API. Подробнее см. в обзоре API Analytics .
Экосистема разработчиков Edge
Apigee Edge предоставляет услуги для разработчиков, которые позволяют вам:
- Управляйте сообществом разработчиков приложений, использующих ваши сервисы.
- Взаимодействовать с внутренними и внешними разработчиками и формализовать отношения с финансовыми моделями.
- Подключите разработчиков и создайте портал для разработчиков. Разработчики приложений подключаются к вашему порталу, чтобы получить доступ к документации по API, узнать больше о ваших общедоступных продуктах API и управлять ключами API.
Каждый клиент Edge может создать собственный портал разработчика, как в облаке, так и локально, с помощью Apigee Edge for Private Cloud.
Apigee Edge позволяет создавать два типа порталов:
- Интегрированный портал , который можно мгновенно настроить. См. раздел «Создание интегрированного портала» .
- Портал на основе Drupal . См. раздел «Создание портала на основе Drupal» .
Монетизация
Возможности монетизации обеспечивают финансовую инфраструктуру и связи, необходимые для превращения вашего сообщества разработчиков в реальный канал для ваших цифровых активов. С помощью монетизации вы можете создавать различные тарифные планы , позволяющие взимать плату с разработчиков за использование ваших API-продуктов или выплачивать им доход на основе схемы распределения прибыли.
В число тарифных планов входят предоплаченные, постоплатные, планы с фиксированной платой, планы с переменной ставкой, планы «freemium», планы, разработанные специально для конкретных разработчиков, планы, охватывающие группы разработчиков, и многое другое. Кроме того, монетизация включает в себя средства отчетности и выставления счетов.
Для получения более подробной информации см. Обзор монетизации .
Вкусы Края
Apigee Edge выпускается со следующими вкусами:
- Публичное облако: размещенная версия SaaS, в которой Apigee поддерживает среду, позволяя вам сосредоточиться на создании собственных сервисов и определении API для этих сервисов.
- Частное облако: локальная установка, в которой вы контролируете аппаратную среду и отвечаете за установку, обновление, техническое обслуживание и другие административные процессы.
Если вас интересует наша гибридная версия Apigee, ознакомьтесь со следующими разделами, посвященными Apigee X:
Функционально версии публичного и частного облака очень похожи. Однако версия частного облака не поддерживает все функции версии публичного облака. К функциям, не поддерживаемым частным облаком, относятся:
- Размещенные цели
- Расширения
- Интегрированные порталы для разработчиков ( Примечание : поддерживаются порталы для разработчиков на основе Drupal)
- мониторинг API
- Смысл
Различия между вкусами можно найти в разделе «Сравнение продуктов Apigee» .
Между API также существуют незначительные различия, описанные в разделе «Различия между Edge для публичного облака и API для частного облака» .
Публичное облако поддерживает как бесплатные, так и платные учетные записи. Для частного облака требуются платные учетные записи.
Для полноценной поддержки локальной установки версия Private Cloud включает такие компоненты, как сервер управления Apigee, база данных NoSQL Apache Cassandra, сервер OpenLDAP, маршрутизатор сообщений и обработчик сообщений.