Konto

Wer bin ich

Beschreibt das aufrufende Token: Art, Anwendung, handelnde Person, Workspaces, Berechtigungen, Modus und Ablauf. Jedes gültige Token darf es lesen.

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

Wer bin ich

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

Wer bin ich

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

Dein erster Aufruf

Sende den Schlüssel im Header Authorization. GET /v1/me zeigt dir, für wen der Schlüssel handelt, seine Workspaces und seine Berechtigungen.

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

Noch keinen Schlüssel? Erstelle ihn unter Einstellungen › API › Persönlicher Zugriff: siehe Authentifizierung.

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Antwort

Die Identität und die Berechtigungen des aufrufenden Tokens.

tokenTypestringerforderlich
Art des Tokens: personal_key, authorization_code oder client_credentials
Zulässige Werte: personal_keyauthorization_codeclient_credentials
applicationobjecterforderlich
Die Anwendung hinter dem Token
Untergeordnete Attribute anzeigen
- idstringerforderlich
  Kennung der Anwendung (oder des persönlichen Schlüssels)
- clientIdstringerforderlich
  Die client_id der Anwendung
- namestringerforderlich
  Name der Anwendung
userobjecterforderlich
Die Person, für die das Token handelt
Untergeordnete Attribute anzeigen
- idstringerforderlich
  Die Person, für die das Token handelt: der Autor des Schlüssels oder wer zugestimmt hat
coveragestringerforderlich
workspace: ein Workspace; account: alle, denen der Autor des Schlüssels angehört
Zulässige Werte: workspaceaccount
workspacesobject[]erforderlich
Wo das Token jetzt handelt
Untergeordnete Attribute anzeigen
- idstringerforderlich
  Kennung des Workspace
- namestringerforderlich
  Benannt nach seinen aktiven Betrieben
scopesstring[]erforderlich
Vom Token gehaltene Berechtigungen
modestringerforderlich
test oder live
Zulässige Werte: testlive
expiresAtstring<date-time>
Wann das Token abläuft; fehlt bei einem Schlüssel ohne Ablauf

War diese Seite hilfreich?