Démarrage rapide

1. Créer une clé personnelle

Dans l’app Sofia, ouvrez Réglages › API, onglet Accès personnel, et créez une clé. Choisissez son nom, son expiration et ses permissions. La clé n’est affichée qu’une fois : copiez-la et gardez-la dans un coffre de secrets, jamais dans votre code.

2. Faire votre premier appel

Envoyez la clé dans l’en-tête Authorization. GET /v1/me vous indique pour qui la clé agit, ses Workspaces et ses permissions.

bash

curl https://api.sofia-post.com/api/v1/me \
  -H "Authorization: Bearer $SOFIA_API_KEY"

json

{
  "tokenType": "personal_key",
  "user": { "id": "cmo7qiltc0000sb1p7zdx1aw4" },
  "coverage": "account",
  "workspaces": [{ "id": "cmo7qiltc0000sb1p7zdx1aw4", "name": "160 food" }],
  "scopes": ["establishments:read", "posts:read", "posts:write"],
  "mode": "live",
  "expiresAt": "2026-11-09T20:09:05.644Z"
}

3. Lister vos établissements

Chaque publication appartient à un établissement. Notez l’id de celui pour lequel vous voulez publier.

bash

curl https://api.sofia-post.com/api/v1/establishments \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Étapes suivantes

Vous êtes prêt pour votre première publication. Pour essayer n’importe quel endpoint depuis votre navigateur, ouvrez la référence de l’API et cliquez sur Essayer.