Настройка API Gateway
API Gateway — это высокопроизводительный, доступный и безопасный сервис размещения API, который помогает создавать, разворачивать программные интерфейсы приложения в любом масштабе и управлять ими.
В этой инструкции описаны настройки API Gateway и прикрепление SSL-сертификата для дальнейшей работы с ботом Telegram.
Создание API Gateway Group
-
В списке сервисов выберите API Gateway.
-
В правом боковом меню выберите Shared Gateways.
-
Выберите API Publishing → API Groups.
-
Нажмите Create API Group.
-
Заполните следующие поля:
-
Name — укажите название группы.
-
Description (опционально) — введите описание.
-
-
Нажмите ОК.
Прикрепление доменного имени к группе
Прежде чем опубликовать API, к принадлежащей ему группе нужно прикрепить один или несколько внешних доменов (до пяти штук). Если доменные имена не привязаны к группе, то API-запрос будет вызываться с использованием технического поддомена и количество вызовов будет ограничено до 1000 в день.
-
В списке сервисов выберите API Gateway.
-
В правом боковом меню выберите Shared Gateways.
-
Выберите API Publishing → API Groups.
-
В строке с нужной группой нажмите More → Manage Domain Name.
-
Нажмите Bind Independent Domain Name.
ВниманиеВ доменном имени должна быть CNAME-запись с именем поддомена группы API. Для этого перейдите на API Group → вкладка Summary и скопируйте имя поддомена в поле Subdomain Name.
-
Введите в поле доменное имя в формате www.example.com и нажмите OK.
После успешного добавления доменного имени появится новая запись.
Прикрепление SSL-сертификата
-
В списке сервисов выберите API Gateway.
-
Выберите API Publishing → API Groups.
-
В строке с нужной группой нажмите More → Manage Domain Name.
-
В строке с нужным доменом нажмите Add SSL Certificate.
-
Заполните поля:
-
Certificate Name — укажите название сертификата.
-
Certificate Content — введите запрос (публичный ключ) сертификата.
-
Private Key — введите приватный ключ вашего сертификата.
-
-
Нажмите ОК.
Создание API
-
В списке сервисов выберите API Gateway.
-
Выберите API Publishing → API Groups.
-
В строке с нужной группой нажмите Manage API.
-
Нажмите Create API.
-
Заполните следующие параметры:
-
Name — укажите название API.
-
API Group — выберите из списка ранее созданную группу.
-
Gateway Response — оставьте ответ по умолчанию.
-
Security Authentication — None. В нашем примере проверка подлинности не нужна.
-
-
Нажмите Next.
-
Заполните поля на странице Define API Request:
-
Protocol — выберите протокол, который будете использовать для API-вызовов. В нашем примере это HTTP& HTTPS.
-
Path — укажите путь для запроса API. Например, «/bot».
-
Matching — выберите:
-
Exact match, чтобы перенаправлять API-запросы точно по указанному пути.
-
Prefix match, чтобы перенаправлять API-запросы по пути, который начинается с указанных в поле значений.
-
-
Method — выберите метод API GET или POST.
-
CORS — по умолчанию (отключен).
-
-
Нажмите Next.
-
Заполните поля на странице Define Backend Request:
-
Backend Type — выберите FunctionGraph.
-
Function URN — нажмите на Select Function URN и выберите из списка ранее созданную функцию в сервисе FunctionGraph, нажмите ОК.
-
Version — LATEST.
-
Invocation Mode — выберите режим вызова функции Synchronous (синхронный).
-
Timeout — укажите длительность времени ожидания. Диапазон: 1–60 000 мс, значение по умолчанию — 5000 мс. Если во время отладки API возникает ошибка времени ожидания бэкенда, то можно увеличить это значение.
-
-
Нажмите Next и затем Finish.
Теперь простой бот для приложения Telegram создан и размещен в облаке с помощью бессерверной функции.
Обычно для запуска такого бота нужно написать код не в виде простого скрипта, а в рамках микросервисной среды, такой как Flask. Для этого нужны веб-сервер для обслуживания кода, SSL-сертификат для обеспечения безопасности соединения и прочее. Но благодаря сервисам облака Advanced FunctionGraph и API Gateway решение этой задачи стало значительно проще.
- Создание API Gateway Group
- Прикрепление доменного имени к группе
- Прикрепление SSL-сертификата
- Создание API