KontoWer bin ich
Zurück zu Sofia

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
GET/v1/me
curl -X GET 'https://api.sofia-post.com/api/v1/me' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorisierungen

  • Authorizationstringerforderlich

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

Antwort

200application/json

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

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.