Réglages développeur
Clés personnelles, clients d’application, et connexion d’un agent ou de la CLI : les commandes de la page Sofia API, et laquelle choisir.
Cette rubrique est l’entrée de tout ce qui est programmatique. La documentation de référence vit dans les onglets API, Agents et Ajouter Sofia à votre app ; cette page décrit les commandes de l’interface. Ouvrez les réglages, rubrique « Sofia API ».
Accès
La page a deux onglets : « Accès personnel » et « Clients d’application ».
Votre clé personnelle
- Créez la clé. « Nouvelle clé » : donnez-lui un nom si vous voulez, une expiration (7 jours, 30 jours, 90 jours, 1 an ou sans expiration) et ses permissions. Toutes sont cochées par défaut ; gardez seulement ce dont votre outil a besoin.
- Copiez-la tout de suite. Elle ne s’affiche qu’une fois, et Sofia n’en garde que l’empreinte.
- Utilisez-la. Envoyez-la dans l’en-tête
Authorization: Bearerde chaque appel. Une clé agit sur tous vos établissements, avec vos droits.
Connecter un assistant IA
Pour Claude, ChatGPT, Cursor, Gemini CLI ou Claude Code, le connecteur des applications connectées est souvent plus simple : il ne demande aucune clé. Voir Le connecteur IA.
CLI et agents
« Copier les instructions pour agent » donne le texte à coller dans votre agent pour qu’il utilise l’API. La commande sofia, publiée sur npm sous le nom sofia-post, enveloppe l’API pour publier depuis un terminal, un script ou une tâche planifiée ; son installation est dans l’onglet « Agents ».
Clients d’application
Un client d’application sert à construire quelque chose que d’autres utilisateurs de Sofia autoriseront, plutôt que quelque chose qui agit comme vous.
- Créez le client. « Nouveau client » : un nom, un logo d’au moins 180 × 180 pixels, l’adresse de votre politique de confidentialité, de une à cinq URL de redirection en HTTPS, et les permissions que l’app peut demander. Le nom et le logo sont montrés aux personnes pendant l’autorisation.
- Copiez les identifiants. Vous obtenez un Client ID et un Client Secret. Un client public, pour une app dont le code est public, n’a pas de secret et s’authentifie avec PKCE ; ce choix est définitif.
- Implémentez le flux. Voir l’onglet « Ajouter Sofia à votre app ».
Clé ou client OAuth ?
| Critère | Clé personnelle | Client d’application |
|---|---|---|
| Agit comme | Vous | La personne qui l’autorise |
| Convient pour | Vos propres scripts et automatisations | Un produit que d’autres utilisateurs de Sofia utiliseront |
| Mise en place | Copier la clé | Déclarer un client et implémenter le flux |
| Pour révoquer | « Révoquer » la clé | La personne retire l’accès dans « Applications connectées », ou vous supprimez le client |
Si vous automatisez votre propre publication, utilisez la clé. Ne construisez un client que lorsque les comptes d’autres personnes sont en jeu.
Pour aller plus loin
- API : points d’accès, charges utiles et réglages par réseau, dans l’onglet API.
- CLI : publier depuis un terminal, dans l’onglet Agents.
- Connecteur IA : brancher Claude, Cursor ou ChatGPT, voir Le connecteur IA.