OAuthEine Autorisierung starten
Zurück zu Sofia

OAuth

Eine Autorisierung starten

Im Browser der Person öffnen. Unbekannter Client oder nicht registrierte redirect_uri ergibt 400, sonst folgt die Weiterleitung zum Zustimmungsbildschirm.

GEThttps://api.sofia-post.com/api/v1/oauth/authorize

Abfrageparameter

  • response_typestringerforderlich

    Muss code sein.

  • client_idstringerforderlich

    Die client_id des Clients.

  • redirect_uristringerforderlich

    Eine registrierte Weiterleitungsadresse, exakt verglichen.

  • scopestringerforderlich

    Die angeforderten Berechtigungen, durch Leerzeichen getrennt (offline_access, um ein Refresh-Token zu erhalten).

  • statestring

    Unverändert zurückgegeben, um den Client vor CSRF zu schützen.

  • code_challengestringerforderlich

    PKCE-Challenge, base64url(SHA-256(code_verifier)), für jeden Client erforderlich.

  • code_challenge_methodstringerforderlich

    Muss S256 sein.

Antwort

302

Leitet zum Zustimmungsbildschirm weiter oder sendet den Fehler an redirect_uri zurück.

400

invalid_client: unbekannter Client oder nicht registrierte redirect_uri.