FE-пайплайн: дать оракулу инструменты

Веб-приложение на 2026-10-15

Слой API: API-пайплайн: дать оракулу инструменты

Цель: дать оракулу инструменты — ваши HTTP-эндпоинты и нужные им ключи — в веб-приложении или в Telegram Mini App.

Шаги

1. Сохраните ключ. Кабинет → Секреты → Создать:

• Имя ключа: secret_<name>_<role>, например secret_shop_api_token (только a-z, 0-9, _; начинается с secret_, 8–64 символа).
• Значение: сам ключ. Больше он не показывается.
• Хост: «ключ отправляется только на этот хост».
• Target workspaces: выберите хотя бы один.
• Создать.

2. Опишите эндпоинт. Кабинет → API-обращения → Создать:

• Заголовок и Содержание: что он делает и когда оракулу им пользоваться.
• Method (GET / POST / PATCH / PUT / DELETE), Path (полный URL или /… с Domain), Operation id (имя инструмента, например orders_status).
• Вставьте ключ в путь или текст как {{secret_shop_api_token}}.
• Создать.

3. Прикрепите. Откройте агенду → API endpoints и Secrets → выберите оба → Сохранить.

Что вы видите

• Секреты показывают каждый ключ только по имени и хосту; значение не возвращается никогда.
• Тот, с кем вы поделились эндпоинтом, может править его текст, но не то, куда он отправляет запросы и какие ключи использует.