Выполнение своих запросов

Тип

GET, POST

Вызов

/custom-execute

Параметры

Имя запроса как указано в параметрах устройства, список параметров, если есть, в формате.

parameter1=value1&parameter2=value2...

Имена параметров запроса должны полностью соответствовать параметрам % в самом запросе.

Пример вызова

http://127.0.0.1:8090/custom-execute/MyQuery?parameter1=value1&parameter2=value2

Формат возвращаемых данных

application/json, структура соответствует данным, поднимаемым запросом.

Описание метода Выполнение своих запросов

В Tillypad API реализован новый метод Выполнение своих запросов. У устройства Модуль связи с сервисом Tillypad API добавлен параметр, в котором можно прописать свой метод.

В Tillypad API добавлен метод, который возвращает разумные, с нашей точки зрения, данные из Tillypad, но Клиент может обращаться к нему не напрямую, а через посредника, которого, например, разработает Дилер.

Этот посредник получит данные по этому запросу через наш API, добавит свои данные и вернет ответ в том виде, который нужен Клиенту.

Для случаев, когда нужно получить данные из Tillypad и передать их в какую-то другую базу (программное обеспечение), в том числе, когда данные в стороннем программном обеспечении сливаются из различных источников.

Важно

Свой запрос нужно прописывать в параметрах устройства Модуль связи с сервисом Tillypad API.

Например, надо добавить метод POST.

http://127.0.0.1:8090/custom-execute/MyQuery?parameter1=value1

Подходит любой тип HTTP-запроса, в том числе POST. Не обязательно добавлять external-процедуру в базу данных. Можно просто задать ее текст в ini-файле QueryExecutor (в параметрах устройства Модуль связи с сервисом Tillypad API).

Для приведенного примера можно добавить в ini-файл:

Важно

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

CustomQueries = (
  Item = (
    Name = 'MyQuery1'
    Streams = 'main'
    SQL = 'Select * FROM ClientPurseOperations where cpop_clnt_ID = %value1'
    )
  Item = (
    Name = 'MyQuery2'
    Streams = 'main'
    SQL = 'Select * FROM Clients where clnt_ID = %value1 and clnt_clgr_ID = %value2'
    )
)

Подсказка

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

CustomQueries = (Item = (Name = 'MyQuery1',  Streams = 'main',  SQL = 'Select * FROM ClientPurseOperations where cpop_clnt_ID = %value1'),  Item = (Name = 'MyQuery2',  Streams = 'main',  SQL = 'Select * FROM Clients where clnt_ID = %value1 and clnt_clgr_ID = %value2'))

Если вы хотите добавить в базу данных external-процедуру, например, MyProc, нужно создать что-то типа:

CREATE PROCEDURE MyProc_External ... ...

В параметре SQL будет просто:

SQL = 'EXEC MyProc_External %value1'