Sorgenti e chiavi

Oltre alle integrazioni predefinite, GetMyBot sa lavorare con API HTTP arbitrarie tramite connettori (sezione Sorgenti) e credenziali (sezione Chiavi). Il connettore descrive dove andare, la chiave — come autenticarsi. Li usano le azioni Richiesta alla sorgente e Scrittura nella sorgente.

Connettori (Sorgenti)

Sezione Sorgenti → Connettori. Un connettore ha Nome, Tipo, URL base, credenziali collegate e intestazioni:

  • REST — qualsiasi API HTTP/JSON.
  • OzmaDB — istanza OzmaDB/FunDB; nell'URL base si specifica la root dell'API REST dell'istanza, e le richieste alle view anonime sono semplificate.
  • IMAP — contrassegnato come «prossimamente».

Il pulsante Verifica esegue una richiesta di test e mostra lo stato e la latenza (o l'errore) — comodo per assicurarsi che URL e chiave siano corretti.

Credenziali (Chiavi)

Sezione Chiavi → Credenziali. I segreti vengono conservati in forma cifrata. Tipi:

  • Chiave API — chiave + nome dell'intestazione (di default Authorization).
  • Bearer token — token nell'intestazione Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, login, password, scope.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh token, scope.

Per OAuth2 la piattaforma ottiene e memorizza nella cache i token in autonomia, aggiornandoli alla scadenza e in risposta a 401; la rotazione del refresh token viene salvata. Durante la modifica, un campo segreto vuoto significa «non modificare».

Lettura e scrittura dalle reazioni

  • Richiesta alla sorgente (ds_query) — legge i dati tramite il connettore in ctx: si specificano il percorso, JSONPath verso l'array e la chiave ctx per il risultato. Poi l'array viene iterato con il ciclo su lista.
  • Scrittura nella sorgente (ds_write) — invia dati (POST/PUT/DELETE) con corpo in formato JSON.

Per richieste una tantum senza connettore salvato esiste l'azione Richiesta web, e per scaricare il testo di una pagina — Carica URL (vedi Azioni).

Passo successivo