Sources et clés

En plus des intégrations prêtes à l'emploi, GetMyBot peut travailler avec des API HTTP arbitraires via des connecteurs (section Sources) et des identifiants (section Clés). Un connecteur décrit où aller, une clé — comment s'authentifier. Ils sont utilisés par les actions Requête vers la source et Écriture vers la source.

Connecteurs (Sources)

Section Sources → Connecteurs. Un connecteur dispose d'un Nom, d'un Type, d'une URL de base, d'identifiants liés et d'en-têtes :

  • REST — toute API HTTP/JSON.
  • OzmaDB — instance OzmaDB/FunDB ; l'URL de base pointe vers la racine de l'API REST de l'instance, et les requêtes vers des vues anonymes sont simplifiées.
  • IMAP — marqué comme « bientôt disponible ».

Le bouton Tester effectue une requête de test et affiche le statut et la latence (ou une erreur) — pratique pour vérifier que l'URL et la clé sont corrects.

Identifiants (Clés)

Section Clés → Identifiants. Les secrets sont stockés sous forme chiffrée. Types :

  • Clé API — clé + nom d'en-tête (par défaut Authorization).
  • Jeton Bearer — jeton dans l'en-tête Authorization: Bearer.
  • OAuth2 (password) — URL du jeton, Client ID/Secret, identifiant, mot de passe, scope.
  • OAuth2 (refresh) — URL du jeton, Client ID/Secret, jeton de rafraîchissement, scope.

Pour OAuth2, la plateforme obtient et met en cache les jetons automatiquement, les renouvelant à leur expiration et sur réponse 401 ; la rotation du jeton de rafraîchissement est conservée. Lors de l'édition, un champ secret vide signifie « ne pas modifier ».

Lecture et écriture depuis les réactions

  • Requête vers la source (ds_query) — lit des données via le connecteur dans ctx : indiquez le chemin, le JSONPath vers le tableau et la clé ctx pour le résultat. Le tableau est ensuite parcouru par une boucle sur liste.
  • Écriture vers la source (ds_write) — envoie des données (POST/PUT/DELETE) avec un corps au format JSON.

Pour des requêtes ponctuelles sans connecteur enregistré, utilisez l'action Requête web, et pour télécharger le texte d'une page — Charger une URL (voir Actions).

Pour aller plus loin

  • Actions — actions Requête vers la source et Écriture vers la source.
  • Substitutions et formules — comment utiliser le résultat depuis ctx.
  • Intégrations — connecteurs prêts à l'emploi pour les services populaires.