Fuentes y claves

Además de las integraciones listas, GetMyBot puede trabajar con APIs HTTP arbitrarias a través de conectores (sección Fuentes) y credenciales (sección Claves). El conector describe a dónde ir, la clave — cómo autenticarse. Los usan las acciones Solicitud a fuente y Escribir en fuente.

Conectores (Fuentes)

Sección FuentesConectores. Un conector tiene Nombre, Tipo, URL base, credenciales vinculadas y encabezados:

  • REST — cualquier API HTTP/JSON.
  • OzmaDB — una instancia de OzmaDB/FunDB; en la URL base se indica la raíz de la REST API de la instancia, y las solicitudes a vistas anónimas se simplifican.
  • IMAP — marcado como «próximamente».

El botón Verificar realiza una solicitud de prueba y muestra el estado y la latencia (o el error) — útil para asegurarte de que la URL y la clave son correctas.

Credenciales (Claves)

Sección ClavesCredenciales. Los secretos se almacenan cifrados. Tipos:

  • Clave API — clave + nombre del encabezado (por defecto Authorization).
  • Token Bearer — token en el encabezado Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, usuario, contraseña, scope.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh-token, scope.

Para OAuth2, la plataforma obtiene y cachea los tokens automáticamente, renovándolos al expirar y ante una respuesta 401; la rotación del refresh-token se conserva. Al editar, un campo de secreto vacío significa «no cambiar».

Lectura y escritura desde las reacciones

  • Solicitud a fuente (ds_query) — lee datos a través del conector en ctx: se especifican la ruta, el JSONPath al array y la clave ctx para el resultado. Luego el array se itera con un bucle sobre lista.
  • Escribir en fuente (ds_write) — envía datos (POST/PUT/DELETE) con el cuerpo en formato JSON.

Para solicitudes puntuales sin un conector guardado está la acción Solicitud web, y para descargar el texto de una página — Cargar URL (ver Acciones).

Qué sigue