Песочница

В Песочнице вы можете воспользоваться методами Tinkoff API в тестовом режиме:

песочница полностью повторяет PROD-контур;
действия с песочницей не влияют на реальные данные;
в песочнице не нужно получать токен;
функциональность песочницы находится в доработке — возможны частые изменения форматов ответов и структуры контрактов.

Авторизация

Для подключения к песочнице не нужно оформлять доступы. Чтобы авторизоваться, используйте токен со значением Bearer TinkoffOpenApiSandboxSecretToken.

Пример запроса и ответа для метода Получить выписку по счёту клиента за определённый период:

Если запрос:

соответствует контракту — ответ будет одинаковым вне зависимости от данных в запросе;
не соответствует контракту — вернётся ошибка.

Тестирование

В песочнице вы можете протестировать:

Формат запроса.
Формат передаваемых данных и валидацию.
Типы возвращаемых значений.
Обработку запросов, отличных от 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, который нужно залогировать.