OAuthНачать авторизацию
Назад к Sofia

OAuth

Начать авторизацию

Откройте в браузере. Неизвестный клиент или незарегистрированный redirect_uri даёт 400; иначе перенаправление на экран согласия Sofia.

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

Параметры запроса

  • response_typestringобязательно

    Должно быть code.

  • client_idstringобязательно

    client_id клиента.

  • redirect_uristringобязательно

    Зарегистрированный адрес перенаправления, сравнивается точно.

  • scopestringобязательно

    Запрашиваемые разрешения через пробел (offline_access, чтобы получить refresh token).

  • statestring

    Возвращается без изменений при возврате, чтобы защитить клиента от CSRF.

  • code_challengestringобязательно

    PKCE-вызов, base64url(SHA-256(code_verifier)), обязателен для каждого клиента.

  • code_challenge_methodstringобязательно

    Должно быть S256.

Ответ

302

Перенаправляет на экран согласия или возвращает ошибку на redirect_uri.

400

invalid_client: неизвестный клиент или незарегистрированный redirect_uri.