Выполнить произвольный запрос

POST

https://secured-openapi.tbank.ru/knapApi/execute

Выполняет произвольный запрос (SELECT) к базе данных 1С. Позволяет передать параметризованный запрос и получить результат в виде массива объектов

Авторизация

Security

Bearer API Token

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

RPS

Ограничение — 5 запросов в секунду

Scopes

Интеграция с КНАП → Методы для работы с документами в Бухгалтерии

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

query

String

Requirements: <= 4000 characters

Текст запроса в формате языка запросов 1С

params

Array of objects ()

Requirements: <= 50 items

Список параметров запроса

Required

name

String

Requirements: <= 100 characters

Имя параметра (без &)

Required

type

String

Requirements: [String, Number, Date, Boolean, GuidReference, Enum]

Тип значения параметра

Required

value

Object

Значение параметра

oneOf

MOD1
MOD2
MOD3

string

Required

select

Array of objects ()

Requirements: <= 200 items

Описание структуры результата запроса

Required

alias

String

Requirements: <= 150 characters

Имя поля в результате запроса (после КАК)

Required

modelFieldname

String

Requirements: <= 150 characters

Имя поля в выходной структуре

Required

type

String

Requirements: [String, Number, Date, Boolean, GuidReference, Enum]

Тип значения

Ответ

200

Результат выполнения запроса

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку