Postman

Postman — это инструмент для работы с API, который позволяет отправлять запросы к сервисам и работать с их ответами. Импортируя коллекцию T‑API через Postman, вы сможете тестировать запросы, изучать документацию и формировать примеры кода на разных языках.

Регистрироваться необязательно. Но если вы зарегистрируетесь, вы сможете читать документацию сразу из Postman. Для работы с API достаточно Free-аккаунта — на нем есть ограничение до 1000 запросов в месяц.

Скачать Postman

Подключение

1. Нажмите Import, чтобы подключить коллекцию.

   
   

2. Вставьте ссылку на yaml документации — https://business.tbank.ru/openapi/docs/openapi.yaml.

   
   

3. Выберите Postman Collection и нажмите Import.

   
   

   Коллекция успешно импортируется — вы увидите дерево запросов, которые можно использовать.

   
   

   Чтобы прочитать описание запроса, нажмите справа.

   
   

Токен

Для всех запросов в T‑API нужен токен, который вы получаете в личном кабинете T‑Бизнеса. Чтобы Postman автоматически подставлял его во все запросы, задайте его как переменную.

Как получить токен

1. Перейдите на вкладку Authorization в любом запросе.

2. Наведите курсор на {{bearerToken}}:

   • В поле Enter value введите токен, который вы получили в личном кабинете T‑Бизнеса.
   • Нажмите Add to и выберите Collection: T‑API. Нажмите Enter.
   
   

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

Параметры

Для некоторых запросов нужно передавать параметры — например, номер счета.

По умолчанию эти поля заполнены тестовыми данными. Чтобы успешно выполнить запрос, введите ваши данные. Их можно посмотреть:

• Для GET-запросов — на вкладке Params.

  
  

• Для POST-запросов — на вкладке Body.

  
  

mTLS-сертификат

Некоторые запросы закрыты mTLS-сертификатом — это сделано для безопасности. Такие запросы помечены . Как выпустить сертификат.

Чтобы добавить сертификат в Postman:

1. Перейдите в настройки, выберите вкладку Certificates и нажмите Add Certificate.

   
   

2. Заполните поля:

   • Host — вставьте secured-openapi.tbank.ru.
   • CRT File — загрузите сертификат, который вам прислали в ответ на заявку. Также его можно выпустить в личном кабинете T‑Бизнеса в разделе Интеграции. Формат файла — .pem.
   • KEY File — загрузите ваш приватный ключ, который вы генерировали в процессе выпуска сертификата.

3. Нажмите Add.

   
   

   После добавления сертификата вы сможете отправлять защищенные запросы .

Postman code snippet

С помощью Postman code snippet можно сгенерировать примеры кода на более чем 20 языках программирования:

1. Перейдите в запрос и нажмите </> на панели справа.

   
   

2. Выберите язык программирования.

   
   

Code snippet не поддерживает сертификаты. Если метод защищенный , добавьте сертификат самостоятельно.

Документация T‑API

Чтобы посмотреть полную документацию T‑API, в левом меню выберите T‑API → View complete documentation.

На странице полной документации можно выбрать язык программирования и получить примеры кода для всех запросов.