Песочница
В песочнице вы можете воспользоваться методами T‑API в тестовом режиме:
- песочница полностью повторяет PROD-контур;
- действия с песочницей не влияют на реальные данные;
- для песочницы не нужно получать токен и выпускать сертификат;
- функциональность песочницы находится в доработке — возможны частые изменения форматов ответов и структуры контрактов.
Авторизация
Для подключения к песочнице доступы не нужны.
Чтобы авторизоваться, используйте токен Bearer TBankSandboxToken
.
Для отправки запроса в песочнице использовать сертификат не нужно.
Пример запроса и ответа для метода Получить выписку по счету клиента за определенный период:
Если запрос:
- соответствует контракту — ответ будет одинаковым вне зависимости от данных в запросе;
- не соответствует контракту — вернется ошибка.
Тестирование
В песочнице вы можете протестировать:
- Формат запроса.
- Формат передаваемых данных и валидацию.
- Типы возвращаемых значений.
- Обработку запросов, отличных от
200
:400
— если формат запроса не соответствует контракту;401
— если передан неверный токен.
- Обработку возвращаемых параметров:
x-request-id
;errorId
;errorMessage
;errorCode
.
Пример
Если вы введете некорректное количество цифр в номере счета в методе получения выписки, вернется ошибка:
{
"errorCode": "INVALID_DATA",
"errorDetails": {
"value": "expected value to match '^(\\d{20}|\\d{22})$', but was '9998888777766665555'"
},
"errorId": "9d1d8855fa",
"errorMessage": "Ваш запрос невалиден: Invalid value for: query parameter accountNumber"
}
В теле ответа будет информация об ошибке и параметр errorId
, который нужно залогировать.