Понимание API и прокси API

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

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

Видео: Посмотрите это короткое видео, чтобы ознакомиться с API-прокси.

Что такое API?

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

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

Apigee Edge позволяет создавать API, и если у вас уже есть API, вы можете напрямую предоставлять к ним доступ, добавляя при этом уровень управления и прозрачности. Если у вас есть сервисы с поддержкой HTTP, такие как веб-сервисы на основе SOA, их также можно предоставлять в виде API через Apigee Edge.

Edge также позволяет создавать API, реализуя приложения, размещенные на платформе API Services, без использования бэкэнд-сервисов. Вы можете создавать такие приложения на JavaScript, Java и Node.js.

Что такое API-прокси?

Вы предоставляете доступ к API в Apigee Edge, используя API-прокси . API-прокси отделяют API, доступный для приложений, от ваших бэкэнд-сервисов, защищая эти приложения от изменений в коде бэкэнда. При внесении изменений в бэкэнд-сервисы приложения продолжают вызывать тот же API без каких-либо прерываний.

В конфигурации API-прокси существуют два типа конечных точек:

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

Визуализацию API-прокси можно выполнить, как показано на графике ниже:

HTTP-запросы поступают через конечную точку запроса прокси-сервера, передаются на конечную точку запроса целевого сервера, а затем отправляются в бэкэнд-сервисы. HTTP-ответы поступают через конечную точку ответа целевого сервера, передаются на конечную точку ответа прокси-сервера, а затем возвращаются клиенту.

Как создать API-прокси?

API-прокси представляет собой набор XML-файлов конфигурации и кода (например, JavaScript и Java). Apigee предоставляет несколько способов создания API-прокси, в том числе:

  • Использование пользовательского интерфейса управления Edge для определения прокси-сервера API в графическом пользовательском интерфейсе (GUI). Подробнее см. раздел «Создание простого прокси-сервера API» .
  • Создание XML-файлов, а также любых других вспомогательных файлов, определяющих ваш API-прокси, и последующий их импорт в Edge.
  • Используйте API управления Edge для создания API-прокси, выполняя серию REST-запросов к Edge.
  • Разверните приложение Node.js в качестве прокси. См. раздел «Развертывание автономного приложения Node.js» .

Что такое политика?

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

Создайте свой первый API-прокси.

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

Отличный способ изучить API-прокси — поработать с примерами, как описано в разделе «Использование примеров API-прокси» .

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