Introduction

Obtenir une clé API

Qu’est-ce que Sofia API ?

Sofia API donne à votre code l’accès à votre compte Sofia : les établissements de vos Workspaces, leurs réseaux connectés, leur médiathèque, leurs publications et leurs statistiques. C’est une API REST en HTTPS. Les requêtes et les réponses sont en JSON, et chaque endpoint se trouve sous une seule URL de base.

text
https://api.sofia-post.com/api/v1

Que peut faire l’API ?

  • Publier : maintenant, à une date ou en brouillon, sur un ou plusieurs réseaux à la fois.
  • Vérifier avant de publier : une simulation vous dit si chaque réseau accepterait la publication, sans rien écrire.
  • Gérer les médias : téléversez un fichier ou importez-le depuis une URL dans la médiathèque d’un établissement.
  • Suivre les publications : lisez l’état de chaque réseau, son lien permanent ou la raison de l’échec. Un webhook signé peut aussi vous prévenir.
  • Lire les statistiques : les derniers chiffres collectés par Sofia pour chaque compte connecté.
  • Connecter des réseaux : créez un lien hébergé qui permet au propriétaire de connecter un réseau manquant.

À qui s’adresse-t-elle ?

Si vous automatisez votre propre Workspace, une clé personnelle suffit : créez-la dans Réglages › API et envoyez-la comme jeton Bearer. Pour un produit SaaS qui agit pour ses utilisateurs sur leurs propres Workspaces, enregistrez un client OAuth : chaque personne autorise votre application sur le Workspace de son choix.

Étapes suivantes