H2H

Обновление токена доступа

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

В результате запроса будет получен новый токен доступа и токен обновления.

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

Если запрос отправляется через 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

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

  • •
    refresh_token
refresh_token
stringrequired

Токен обновления. Обновить access_token через refresh_token можно только 2 раза. В дальнейшем необходимо использовать новый refresh_token

client_id
stringrequired

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

client_secret
stringrequired

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

Пример запроса
Язык
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=refresh_token' \
5--data-urlencode 'refresh_token=13b8230b-b6bf-4bb9-b977-3bc0a988a5fd' \
6--data-urlencode 'client_id=0cee0683-85ae-49f2-a63d-29f97aad1911' \
7--data-urlencode 'client_secret=Qwerty1234567890Qwerty1234567890!'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "access_token": "eyJraWQiOiJhbGZhLXRlc3Qtand0IiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIzMjI4ZTY4ZS1jYzM0LTRiODItYjQzZC00OTExMmI1ZDlkM2UiLCJhdWQiOiIwY2VlMDY4My04NWFlLTQ5ZjItYTYzZC0yOWY5N2FhZDE5MTEiLCJpc3MiOiJodHRwczpcL1wvaWQuYWxmYWJhbmsucnUiLCJleHAiOjE2MzE2NjY2NjMsInNjb3BlX3NlcnZpY2VzIjpbInBheW1lbnQiLCJzdGF0ZW1lbnQiXSwiaWF0IjoxNjMxNjYzMDYzLCJzY29wZV9jbGFpbXMiOlsibmFtZSIsImdpdmVuX25hbWUiLCJmYW1pbHlfbmFtZSIsIm1pZGRsZV9uYW1lIiwiZW1haWwiLCJwaG9uZV9udW1iZXIiXX0.RZ98I-PT_HGMzc7IbwGvlZjLOYuInta6pczEc_h4yCvZKCafIqs4ZBbs7eSY3NpXGzTbSZkGQA9wfX2NFDXZelwyNTooFQMpXzytrEhLww05H8ZFCH0kEQ_IpnJk-KeYkBLD0Oa75Gi6Lqj-Dr8KoX4Zq93ZyT4sr7Hzb1H287UlkJWVlpz_E7slLIob8m3keGbDysNyEBKJzsPcW27HENZBnvYwdE1pzwB8ObEZkICO8kbEP7MupLbhFyjxJFlI6Bq2DNjqi_QgQzvjvpD4KILxDms-Upg8h6GptYyoOl1BMGfN7WhN2vOUFYNuivNKctwcfD_H73kHJGu5KIJmGA",
3  "refresh_token": "2cc8d34c-130a-4674-91fa-f9835fff6e88",
4  "token_type": "Bearer",
5  "expires_in": 3600
6}
HEADERS
Атрибут
Описание
Content-Type
stringoptional

application/json

Cache-Control
stringoptional

no-store

Pragma
stringoptional

no-cache

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

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

refresh_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  "refresh_token": "2cc8d34c-130a-4674-91fa-f9835fff6e88",
4  "token_type": "Bearer",
5  "expires_in": 3600
6}
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}

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

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