Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
В этом разделе перечислены некоторые основные характеристики прокси-серверов API, а также ссылки на дополнительную информацию.
API — это точки входа, позволяющие одному приложению использовать возможности другого. Вы реализуете прокси API для создания API.
В Apigee Edge вы реализуете прокси-серверы API, настраивая логику прокси-сервера API как последовательность шагов, которые выполняются в ответ на запрос клиентского кода. Вы предоставляете клиентам прокси-сервер API, определяя конечные точки, которые включают URL-адрес с путями к ресурсам, команду HTTP, требования к телу и т. д.
Хотя он и называется API-прокси, с точки зрения клиентского кода это API .
Обзор прокси-серверов API см. в разделе Общие сведения об API и прокси-серверах API .
Вы организуете последовательность логики API-прокси с помощью потоков.
В любом приложении данные проходят через приложение, руководствуясь логикой условий. В Apigee Edge путь обработки состоит из потоков. Поток — это последовательность этапов (или «шагов»), составляющих путь обработки прокси-сервера API. Потоки — это то, как Apigee Edge предоставляет вам места для применения логики и поведения в определенных местах от клиента к внутреннему ресурсу, а затем обратно к клиенту.
Дополнительные сведения о потоках см. в разделе Управление работой прокси-сервера с помощью потоков.
Вы получаете доступ к данным о состоянии через переменные потока, созданные прокси API.
Прокси API имеет доступ к переменным, которые представляют состояние выполнения. Вы можете получить доступ к этим переменным из XML, который настраивает ваши прокси-серверы API и политики. Вы также можете получить к ним доступ при расширении прокси-сервера API с помощью процедурного языка, такого как Java, JavaScript или Python.
Эти переменные хранятся в Apigee Edge. Некоторые существуют по умолчанию, обычно потому, что они являются общими для действий прокси-серверов API (например, потому, что они являются частью HTTP-запроса). Вы также можете создавать свои собственные переменные для удовлетворения логических требований.
Дополнительные сведения о переменных см. в разделе Управление состоянием прокси-сервера с помощью переменных потока .
Вы можете заставить прокси API выполняться условно.
Как и в большинстве языков программирования, в прокси-серверах API код может выполняться условно. Условия часто основаны на состоянии прокси-сервера API, к которому вы можете получить доступ через переменные потока. Например, у вас может быть условие, которое проверяет пользовательский агент, а затем соответствующим образом обрабатывает запрос.
Дополнительные сведения об условном выполнении см. в разделе Переменные и условия потока .
Вы реализуете большую часть логики в прокси-сервере API, используя политики.
Большая часть логики, которую вы добавляете в прокси-сервер API, упакована в виде политик. Политика — это компонент Apigee Edge, который инкапсулирует логику для функциональной области, такой как безопасность или управление трафиком. Вы настраиваете политику с помощью XML, который устанавливает свойства для базовой логики. Вы организуете политики в последовательность «шагов» внутри потока, чтобы ваш прокси-сервер API выполнял логику в наилучшем порядке для целей вашего прокси-сервера.
Дополнительные сведения о политиках см. в разделе Что такое политика? .
Вы можете включать повторно используемые наборы функций.
Если ваш прокси API включает логику, которая будет использоваться из разных мест вашего кода (например, из других прокси API), вы можете собирать эту логику для вызовов из разных мест. Например, вы можете сгруппировать логику безопасности в общий поток, который вызывают другие прокси-серверы API, что уменьшит дублирование между прокси-серверами API.
Дополнительные сведения об общих потоках см. в разделе Многоразовые общие потоки . Дополнительные сведения о цепочке прокси-серверов API см. в разделе Объединение прокси-серверов API в одну цепочку .
Вы можете отлаживать прокси с помощью инструмента Trace.
Apigee Edge включает в себя инструмент трассировки, который можно использовать для проверки потока выполнения вашего прокси-сервера API при отладке и тестировании. Инструмент визуально представляет каждый шаг прокси-сервера API, который выполняется для запроса. Как и в отладчике, на каждом шаге вы можете просмотреть список значений переменных, составляющих состояние API-прокси.
Дополнительные сведения об отладке с помощью Trace см. в разделе Использование инструмента Trace .
Вы обрабатываете ошибки прокси-сервера API как неисправности.
Настроив обработчик ошибок, вы можете настроить ошибку, возвращаемую клиенту API. Обработчики ошибок дают вам контроль над сообщениями об ошибках, независимо от того, возникла ли ошибка из вашего собственного кода или из включенного компонента (например, политики).
Дополнительную информацию см. в разделе Обработка ошибок .