Guida rapida

1. Creare una chiave personale

Nell'app Sofia apri Impostazioni › API, scheda Accesso personale, e crea una chiave. Scegli il nome, la scadenza e i permessi. La chiave viene mostrata una sola volta: copiala e conservala in un secret store, mai nel tuo codice.

2. Fare la prima chiamata

Invia la chiave nell'header Authorization. GET /v1/me ti dice per chi agisce la chiave, i suoi Workspace e i suoi permessi.

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. Elencare le tue attività

Ogni pubblicazione appartiene a un'attività. Annota l'id di quella per cui vuoi pubblicare.

bash

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

Prossimi passi

Sei pronto per la tua prima pubblicazione. Per provare qualsiasi endpoint dal browser, apri il riferimento API e premi Prova.