B2BB2CH2H

Получение токена доступа

Песочница
POST https://sandbox.alfabank.ru/oidc/token
Пром
POST https://baas.alfabank.ru/oidc/token
Описание

Будет получен access_token .

При использовании curl запроса с заголовком "Content-Type": "application/x-www-form-urlencoded" необходимо экранировать специальные символы параметра client_secret . Если запрос отправляется через Postman с заголовком "Content-Type": "application/x-www-form-urlencoded" и body в формате x-www-form-urlencoded - нет необходимости экранировать специальные символы.

Подробную информацию по экранированию можно посмотреть здесь.

Параметры запроса
HEADERS
Атрибут
Описание
Accept
stringrequired

application/json

Content-Type
stringrequired

application/x-www-form-urlencoded

BODY
Атрибут
Описание
grant_type
stringrequired

Тип гранта. Возможные значения:

  • •
    client_credentials
client_id
stringrequired

Идентификатор партнёрского сервиса

client_secret
stringrequired

Секретный ключ партнёрского сервиса

scope
stringrequired

Область применения токена доступа (партнёр API информирует, какие scopes будут использованы). Рекомендуется указывать весь доступный scope через знак пробела или %20

Пример запроса
Язык 
1curl --location 'https://baas.alfabank.ru/oidc/token' \
2--header 'Content-Type: application/x-www-form-urlencoded' \
3--header 'Accept: application/json' \
4--data-urlencode 'grant_type=client_credentials' \
5--data-urlencode 'client_id=0cee0683-85ae-49f2-a63d-29f97aad1911' \
6--data-urlencode 'client_secret=Qwerty1234567890Qwerty1234567890!' \
7--data-urlencode 'scope=string'
Параметры ответа
Пример ответа 200 (OK) 
1{
2  "access_token": "eyJraWQiOiJhbGZhLXRlc3Qtand0IiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIzMjI4ZTY4ZS1jYzM0LTRiODItYjQzZC00OTExMmI1ZDlkM2UiLCJhdWQiOiIwY2VlMDY4My04NWFlLTQ5ZjItYTYzZC0yOWY5N2FhZDE5MTEiLCJpc3MiOiJodHRwczpcL1wvaWQuYWxmYWJhbmsucnUiLCJleHAiOjE2MzE2NjY2NjMsInNjb3BlX3NlcnZpY2VzIjpbInBheW1lbnQiLCJzdGF0ZW1lbnQiXSwiaWF0IjoxNjMxNjYzMDYzLCJzY29wZV9jbGFpbXMiOlsibmFtZSIsImdpdmVuX25hbWUiLCJmYW1pbHlfbmFtZSIsIm1pZGRsZV9uYW1lIiwiZW1haWwiLCJwaG9uZV9udW1iZXIiXX0.RZ98I-PT_HGMzc7IbwGvlZjLOYuInta6pczEc_h4yCvZKCafIqs4ZBbs7eSY3NpXGzTbSZkGQA9wfX2NFDXZelwyNTooFQMpXzytrEhLww05H8ZFCH0kEQ_IpnJk-KeYkBLD0Oa75Gi6Lqj-Dr8KoX4Zq93ZyT4sr7Hzb1H287UlkJWVlpz_E7slLIob8m3keGbDysNyEBKJzsPcW27HENZBnvYwdE1pzwB8ObEZkICO8kbEP7MupLbhFyjxJFlI6Bq2DNjqi_QgQzvjvpD4KILxDms-Upg8h6GptYyoOl1BMGfN7WhN2vOUFYNuivNKctwcfD_H73kHJGu5KIJmGA",
3  "token_type": "Bearer",
4  "expires_in": 3600
5}
HEADERS
Атрибут
Описание
Content-Type
stringoptional

application/json

Cache-Control
stringoptional

no-store

Pragma
stringoptional

no-cache

BODY
атрибут
описание
access_token
stringrequired

Токен доступа

token_type
stringrequired

Тип токена

expires_in
integeroptional

Срок жизни токена в секундах

Пример ответа 200 (OK) 
1{
2  "access_token": "eyJraWQiOiJhbGZhLXRlc3Qtand0IiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIzMjI4ZTY4ZS1jYzM0LTRiODItYjQzZC00OTExMmI1ZDlkM2UiLCJhdWQiOiIwY2VlMDY4My04NWFlLTQ5ZjItYTYzZC0yOWY5N2FhZDE5MTEiLCJpc3MiOiJodHRwczpcL1wvaWQuYWxmYWJhbmsucnUiLCJleHAiOjE2MzE2NjY2NjMsInNjb3BlX3NlcnZpY2VzIjpbInBheW1lbnQiLCJzdGF0ZW1lbnQiXSwiaWF0IjoxNjMxNjYzMDYzLCJzY29wZV9jbGFpbXMiOlsibmFtZSIsImdpdmVuX25hbWUiLCJmYW1pbHlfbmFtZSIsIm1pZGRsZV9uYW1lIiwiZW1haWwiLCJwaG9uZV9udW1iZXIiXX0.RZ98I-PT_HGMzc7IbwGvlZjLOYuInta6pczEc_h4yCvZKCafIqs4ZBbs7eSY3NpXGzTbSZkGQA9wfX2NFDXZelwyNTooFQMpXzytrEhLww05H8ZFCH0kEQ_IpnJk-KeYkBLD0Oa75Gi6Lqj-Dr8KoX4Zq93ZyT4sr7Hzb1H287UlkJWVlpz_E7slLIob8m3keGbDysNyEBKJzsPcW27HENZBnvYwdE1pzwB8ObEZkICO8kbEP7MupLbhFyjxJFlI6Bq2DNjqi_QgQzvjvpD4KILxDms-Upg8h6GptYyoOl1BMGfN7WhN2vOUFYNuivNKctwcfD_H73kHJGu5KIJmGA",
3  "token_type": "Bearer",
4  "expires_in": 3600
5}
HEADERS
Атрибут
Описание
Content-Type
stringoptional

application/json

Cache-Control
stringoptional

no-store

Pragma
stringoptional

no-cache

BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    invalid_request - неверные входные параметры запроса
error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request) 
1{
2  "error": "invalid_request",
3  "error_description": "string"
4}
Описание клэймов access_token
Name Description
iss URL-адрес Alfa ID по протоколу https (https://id.alfabank.ru/oidc)
aud Идентификатор сервиса-партнёра (аудитория токена). Может также содержать идентификаторы для других сервисов. Представляется в виде массива строк с учётом регистра, либо может быть одной строкой
exp Время окончания срока действия идентификационного токена. Представляет собой JSON с указанием количества секунд от 1970-01-01T0:0:0Z в формате UTC до даты/времени
iat Время выпуска JWT. Значение - количество секунд до указанной даты/времени от 1970-01-01T0:0:0Z в формате UTC
scope_services Массив операций области применения
Таблица возможных значений параметра error
Значение Описание
invalid_request Отсутствует обязательный параметр, неподдерживаемое значение параметра (кроме grant_type), повторение параметра, несколько учётных данных или неправильный формат запроса
invalid_client Ошибка аутентификации клиента (неверный client_id или client_secret, отключённая аутентификация клиента или неподдерживаемый метод аутентификации)
invalid_grant Недействительное разрешение авторизации (недействительный код авторизации, токен обновления или несоответствие URI перенаправления)
unsupported_grant_type Тип разрешения на авторизацию (grant_type) не поддерживается сервером авторизации
internal_error Произошла непредвиденная ошибка

Отправьте письмо на alfa_api@alfabank.ru, указав следующие данные:

  1. 1.
    client_id.
  2. 2.
    Дата и время запроса с указанием часового пояса.
  3. 3.
    Метод и URI запроса.
  4. 4.
    Заголовки и тело запроса.
  5. 5.
    Полученная ошибка и заголовки ответа, включая X-TraceId.
  6. 6.
    IP-адрес, с которого был отправлен запрос.
Как использовать CCFПроверка подписи