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.