Добавление API вручную

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

В этой статье приводятся действия по добавлению API вручную в экземпляр Управления API. Если требуется макетировать API, можно создать пустой API-интерфейс или определить его вручную. Сведения об имитации API см. в статье Mock API responses (Имитация ответов API).

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

В этой статье мы создадим пустой API и укажем httpbin.org (общедоступную службу тестирования) в качестве API серверной части.

Необходимые компоненты

Выполните задачи из краткого руководства по созданию экземпляра службы управления API Azure

Перейдите к экземпляру службы управления API.

1. На портале Azure найдите и выберите службы Управление API.

   

2. На странице Службы Управления API выберите экземпляр Управления API.

   

Создание API

1. На портале Azure перейдите к службе "Управление API" и в меню выберите Интерфейсы API.
2. Выберите + Add API (+ Добавить API) в меню слева.
3. Выберите HTTP из списка.
   
4. Укажите URL-адрес веб-службы серверной части (например, https://httpbin.org) и другие параметры API. Эти параметры описаны в руководстве Импорт и публикация первого интерфейса API.
5. Нажмите кнопку создания.

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

Добавление и проверка операции

В этом разделе показано, как добавить операцию /get и сопоставить ее с операцией серверной части "http://httpbin.org/get"

Добавление операции

1. Выберите API, созданный на предыдущем шаге.
2. Щелкните + Add Operation (+ Добавить операцию).
3. В поле URL-адрес выберите значение GET и введите /get в качестве значения ресурса.
4. Введите FetchData в поле Отображаемое имя.
5. Выберите Сохранить.

Проверка операции

Проверка функции выполняется на портале Azure. Тестировать API можно также на портале разработчика.

1. Откройте вкладку Тест.
2. Выберите FetchData.
3. Нажмите кнопку Отправить.

Появится сообщение с ответом, который создает операция "http://httpbin.org/get" Если вы хотите преобразовать операцию, используйте инструкции из статьи Transform and protect your API (Преобразование и защита API).

Добавление и проверка параметризованной операции

В этом разделе показано, как добавить операцию, которая принимает параметр. Здесь мы сопоставим операцию с адресом "http://httpbin.org/status/200"

Добавление операции

1. Выберите API, созданный на предыдущем шаге.
2. Щелкните + Add Operation (+ Добавить операцию).
3. В поле URL-адрес выберите значение GET и введите /status/{code} в качестве значения ресурса. Здесь же можно указать полезные сведения об этом параметре. Например, укажите значение номер в поле тип и число 200 (по умолчанию) в поле значения.
4. Введите отображаемое имя GetStatus.
5. Выберите Сохранить.

Проверка операции

Проверка функции выполняется на портале Azure. Тестировать API можно также на портале разработчика.

1. Откройте вкладку Тест.

2. Выберите GetStatus. По умолчанию устанавливается значение кода 200. Его можно изменить, чтобы проверить работу других значений. Например, введите значение 418.

3. Нажмите кнопку Отправить.

   Появится сообщение с ответом, который создает операция "http://httpbin.org/status/200" Если вы хотите преобразовать операцию, используйте инструкции из статьи Transform and protect your API (Преобразование и защита API).

Добавление и проверка операции с подстановочным знаком

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

Добавление операции

1. Выберите API, созданный на предыдущем шаге.
2. Щелкните + Add Operation (+ Добавить операцию).
3. В поле URL-адрес выберите значение GET и введите /* в качестве значения ресурса.
4. В качестве отображаемого имени введите WildcardGet.
5. Выберите Сохранить.

Проверка операции

Проверка функции выполняется на портале Azure. Тестировать API можно также на портале разработчика.

1. Откройте вкладку Тест.

2. Выберите WildcardGet. Попробуйте выполнить операции GET, протестированные в предыдущих разделах, или воспользуйтесь другой поддерживаемой операцией GET.

   Например, в параметрах шаблона измените значение для подстановочного знака (*) на headers. Операция возвращает HTTP-заголовки входящего запроса.

3. Нажмите кнопку Отправить.

   Появится сообщение с ответом, который создает операция "http://httpbin.org/headers" Если вы хотите преобразовать операцию, используйте инструкции из статьи Transform and protect your API (Преобразование и защита API).

Добавление других интерфейсов API

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

• Спецификация OpenAPI
• A SOAP API
• A GraphQL API
• Веб-приложение, размещенное в Службе приложений Azure
• Приложение-функция Azure
• Приложения логики Azure
• Azure Service Fabric

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

1. Перейдите в свой экземпляр службы "Управление API" на портале Azure.

   

2. Выберите API на странице Обзор или в меню слева.

   

3. Щелкните ...рядом с API, к которому нужно добавить другой API.

4. В раскрывающемся меню выберите Импорт.

   

5. Выберите службу, из которой следует импортировать API.

   

См. также

• Ограничения импорта API
• Импорт спецификации OpenAPI
• Импорт SOAP API
• Импорт SOAP API и его преобразование в REST
• Импорт API Службы приложений
• Импорт API контейнерного приложения
• Импорт API WebSocket
• Импорт API GraphQL
• Импорт схемы GraphQL и настройка сопоставителей полей
• Импорт приложения-функции Azure
• Импорт приложения логики Azure
• Импорт службы Service Fabric
• Импорт API OpenAI Azure
• Импорт API OData
• Импорт метаданных SAP OData
• Импорт API gRPC
• Изменение API

Следующие шаги