Account

Chi sono

Descrive il token chiamante: tipo, applicazione, persona per cui agisce, Workspace, permessi, modalità e scadenza. Qualsiasi token valido può leggerlo.

GEThttps://api.sofia-post.com/api/v1/me

Chi sono

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

{
  "tokenType": "personal_key",
  "application": {
    "id": "string",
    "clientId": "sofia_app_live_3f9c…",
    "name": "Atelier CRM"
  },
  "user": {
    "id": "string"
  },
  "coverage": "workspace",
  "workspaces": [
    {
      "id": "string",
      "name": "Bistrot Lumière Lyon 2e"
    }
  ],
  "scopes": [
    "establishments:read"
  ],
  "mode": "test"
}

Chi sono

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/me' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "tokenType": "personal_key",
  "application": {
    "id": "string",
    "clientId": "sofia_app_live_3f9c…",
    "name": "Atelier CRM"
  },
  "user": {
    "id": "string"
  },
  "coverage": "workspace",
  "workspaces": [
    {
      "id": "string",
      "name": "Bistrot Lumière Lyon 2e"
    }
  ],
  "scopes": [
    "establishments:read"
  ],
  "mode": "test"
}

La tua prima chiamata

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

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

{
  "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"
}

Non hai ancora una chiave? Creala in Impostazioni › API › Accesso personale: vedi Autenticazione.

Autorizzazioni

Authorizationstringheaderobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Risposta

L'identità e i permessi del token chiamante.

tokenTypestringobbligatorio
Tipo di token: personal_key, authorization_code o client_credentials
Valori ammessi: personal_keyauthorization_codeclient_credentials
applicationobjectobbligatorio
L'applicazione dietro il token
Mostra gli attributi figli
- idstringobbligatorio
  Identificatore dell'applicazione (o della chiave personale)
- clientIdstringobbligatorio
  Il client_id dell'applicazione
- namestringobbligatorio
  Nome dell'applicazione
userobjectobbligatorio
La persona per cui agisce il token
Mostra gli attributi figli
- idstringobbligatorio
  La persona per cui agisce il token: l'autore della chiave, o chi ha dato il consenso
coveragestringobbligatorio
workspace: un Workspace; account: tutti quelli di cui fa parte l'autore della chiave
Valori ammessi: workspaceaccount
workspacesobject[]obbligatorio
Dove agisce ora il token
Mostra gli attributi figli
- idstringobbligatorio
  Identificatore del Workspace
- namestringobbligatorio
  Prende il nome dalle sue attività attive
scopesstring[]obbligatorio
Permessi del token
modestringobbligatorio
test o live
Valori ammessi: testlive
expiresAtstring<date-time>
Quando scade il token; assente per una chiave senza scadenza

Questa pagina ti è stata utile?