Pipeline FE: dar herramientas a tu oráculo

App web a fecha de 2026-10-15

Capa API: Pipeline de API: dar herramientas a tu oráculo

Objetivo: dar herramientas a tu oráculo — tus propios endpoints HTTP y las claves que necesitan — en la app web o en la Mini App de Telegram.

Pasos

1. Guarda la clave. Gabinete → Secretos → Nuevo:

• Nombre de la clave: secret_<name>_<role>, p. ej. secret_shop_api_token (solo a-z, 0-9, _; empieza por secret_, 8–64 caracteres).
• Valor: la clave en sí. No se vuelve a mostrar.
• Host: «la clave solo se envía a este host».
• Target workspaces: elige al menos uno.
• Crear.

2. Describe el endpoint. Gabinete → Endpoints API → Nuevo:

• Título y Contenido: qué hace y cuándo debe usarlo el oráculo.
• Method (GET / POST / PATCH / PUT / DELETE), Path (una URL completa, o /… con Domain), Operation id (el nombre de la herramienta, p. ej. orders_status).
• Pon la clave en la ruta o el texto como {{secret_shop_api_token}}.
• Crear.

3. Adjunta. Abre tu agenda → API endpoints y Secrets → elige ambos → Guardar.

Lo que ves

• Secretos muestra cada clave solo por nombre y host; el valor nunca vuelve.
• Alguien con quien compartes un endpoint puede editar su texto, pero no adónde envía ni qué claves usa.