Appearance
Сервис авторизации для получения JWT Bearer токена
Для аутентификации необходимо воспользолваться сервисом Auth v1 https://sapi.airbapay.kz/auth/swagger/index.html#/
Так же партнеру нужно реализовать сервис аутентификации для авторизации в сервис описанный выше. Описание сервиса аутентификации https://sapi.airbapay.kz/bg-proxy-general/swagger/index.html#/Partners/post_authenticate
Метод: POST
Адрес:
Тест: https://sapi.airbapay.kz/auth/api/v1/authenticate
Прод: https://api.airbapay.kz/auth/api/v1/authenticate
Креды для доступа userId, userSecret предоставляет команда AirbaPay
Сервис возвращает JWT токен. Вы можете его распарсить на сайте JSON Web Tokens - jwt.io. В нем содержится время жизни токена (UNIX time, seconds after epoch, согласно стандарту)
Структура запроса:
Параметр | Тип | Обязательно |
---|---|---|
userId | string | да |
userSecret | string | да |
Тело запроса:
json
{
"userId": "612799c9d72fbae710adfc9a",
"userSecret": "secretValue"
}
Пример запроса:
curl -X POST "https://sapi.airbapay.kz/auth/api/v1/authenticate" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"userId\": \"3c455e0b-e28c-43a5-bb81-2c10d20dd2c9\", \"userSecret\": \"PflNgZnDJbVpe0I0f2i0PZIM2dOB6ukR\"}"
Структура ответа:
Параметр | Тип | Описание |
---|---|---|
accessToken | string | Токен |
expiresIn | int | Срок жизни токена в секундах |
tokenType | string | Тип токена |
Пример ответа:
Заголовок 200, ОК
json
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzeXN0ZW0iOiJzaG9wX2R5c29uIiwiZXhwIjoxNjk2NTg1OTkzLCJzdWIiOiJicm9rZXItZ29vZHMifQ.9DbXyrh6NKI2FPLvqYM25UmgMAK1ARLXuzKejJqaY-I",
"expiresIn": 7200,
"tokenType": "bearer"
}
Отрицательные ответы:
Структура:
Параметр | Тип | Описание |
---|---|---|
status | string | Статус ошибки |
code | int | Код ошибки |
message | string | Сообщение ошибки |
Заголовок 400, Bad Request
json
{
"error": {
"status": "Invalid Credentials",
"code": 401,
"message": "userSecret not specified"
}
}
При такой ошибке проверить название полей и структуру сообщения
Заголовок 401, Unauthorized
json
{
"error": {
"status": "Invalid Credentials",
"code": 401,
"message": "invalid userId or secret"
}
}
При такой ошибке проверьте валидность username, password
Заголовок 500, Internal Server Error
json
{
"error": {
"code": 500,
"message": "Internal Server Error",
"status": "nil pointer dereference"
}
}
При такой ошибке пробуйте заново или обратитесь за помощью к команде AirbaPay