© Tillypad, 2004-2022

© Tillypad, 2004-2022
Возвращает список всех групп элементов прейскуранта и список всех концепций.
GET
/get-menu-groups-and-conceptions
Без параметров.
http://89.22.216.169:8090/get-menu-groups-and-conceptions
{ "MenuGroups": [ { "mgrp_ID": "9C3D6192-9FFA-A848-8C6E-D5629F9128AD", "mgrp_mgrp_ID_Parent": "BA1D021F-754A-FB4A-921B-16DD3128C478", "mgrp_Name": "Чай, кофе", "mgrp_Description": "ДВК", "mgrp_NotForSale": false, "mgrp_IsDisabled": false, "mgrp_Order": 24 }, ... ], "Conceptions": [ { "cncpt_ID": "BFB3FB23-F0CB-644C-B441-E079109753F2", "cncpt_slpr_ID": "364FAAE6-4D90-4645-9523-FD9A5D54705C", "cncpt_Name": "2 Палочки СПб", "cncpt_Phones": "<Phones><Phone>3</Phone></Phones>" }, ... ] }
Таблица tp_MenuGroups.
Таблица tp_Conceptions.
GET
/get-divisions
Без параметров.
http://89.22.216.169:8090/get-divisions
[ { "dvsn_ID": "B125BE00-8B8C-CC40-99AC-088B5A95EF67", "dvsn_Name": "OZR_Доставка_Энгельса 124", "dvsn_GeoIdentifier": "OZR_Энгельса_124" }, ... ]
GET
/get-discount-point-types
Без параметров.
http://89.22.216.169:8090/get-discount-point-types
[ { "dspt_ID": "A976C6ED-C511-4755-B942-636645A6A1B0", "dspt_Name": "баллы 1", "dspt_Description": "баллы 1", "dspt_IsPermanent": false }, { "dspt_ID": "C635BB7D-DE32-41F1-878C-8050F57C1826", "dspt_Name": "баллы 2", "dspt_Description": "баллы 2", "dspt_IsPermanent": false } ]
Таблица tp_DiscountPointTypes.
GET
/get-purse-types
Без параметров.
http://89.22.216.169:8090/get-purse-types
[ { "cptp_ID": "573250C8-5007-4AAF-8596-4F820E9B6648", "cptp_Name": "местные счета", "cptp_Description": "описание" } ]
Таблица tp_ClientPurseTypes.
GET
/get-places
dvsn_ID из таблицы tp_Divisions: GUID подразделения, которому принадлежат группы мест размещения.
Если не передан, то возвращаются все группы и места.
http://127.0.0.1:8090/get-places?division-id=8051B912-B90C-1045-9AA9-05A049551B57
Список групп мест размещения и мест размещения каждой группы.
Места размещения tp_Places, группы мест размещения tp_PlaceGroups.
{ "PlaceGroups": [ { "plgr_ID": "FC2334D9-BA0E-3347-A9DC-225B27199A44", "plgr_dvsn_ID": "7917642D-FF72-3B47-8ED8-04052BC144CB", "plgr_Name": "Test" }, { "plgr_ID": "2D193B75-214D-EB48-A51F-BC31143081AD", "plgr_plgr_ID_Parent": "FC2334D9-BA0E-3347-A9DC-225B27199A44", "plgr_dvsn_ID": "BF4EBEB6-97D1-9647-9AFB-9CB5AE39DA0A", "plgr_Name": "TestChild" } ], "Places": [ { "plac_ID": "A4F7F360-C963-474A-B2ED-6C499310D9B2", "plac_plgr_ID": "FC2334D9-BA0E-3347-A9DC-225B27199A44", "plac_pltp_ID": "57216144-1E9A-4A5B-9AEE-0AB671B08725", "plac_Name": "TestPlace", "plac_ShortName": "shortname", "plac_Description": "desc", "plac_Number": 1, "plac_Count": 0, "plac_sprv_ID_Order": "A06AA357-EC7D-CC43-BA2E-E87C9776D391" }, { "plac_ID": "BB43306C-F103-5D4C-BBEF-9A6A972C7A2C", "plac_plgr_ID": "2D193B75-214D-EB48-A51F-BC31143081AD", "plac_pltp_ID": "57216144-1E9A-4A5B-9AEE-0AB671B08725", "plac_Name": "TestChildPlace", "plac_Number": 2, "plac_Count": 0 }, { "plac_ID": "B08D44A0-E6EF-8E46-8AC5-BAF7C37DF350", "plac_plgr_ID": "FC2334D9-BA0E-3347-A9DC-225B27199A44", "plac_pltp_ID": "27477B71-D557-4EF0-9998-BF10CD6E2BC4", "plac_aordr_ID": "0A4D3F70-09EE-4149-998C-E36D698F6BC9", "plac_Name": "TestPlace2", "plac_ShortName": "short", "plac_Description": "тест", "plac_Number": 3, "plac_Count": 0, "plac_sprv_ID_Order": "BB080EFE-EF89-D54A-9827-D25428C35EF0" } ] }
POST
/post-identifier
{ "idnt_ID": "670BF67D-5CA1-D949-A7A9-9BC79AA30EA3" }
В секции BODY
запроса содержимое идентификатора. В секции HEADER
необходимо указать "Content-Type: application/json"
.
Все даты в формате 'yyyy-MM-dd'T'HH:mm:ss'
.
Идентификатор на входе
{ "idnt_Code": "123", "idnt_Name": "Name" }
Ответ
{ "idnt_ID": "E90648DF-5F4A-1A4F-990A-E4BF2B09FA2E" }
Если идентификатор с idnt_Code и idnt_idtp_ID уже существует, то будет возвращена ошибка.
Если значение idnt_idtp_ID не передано, оно может быть получено от устройства.
Если значение idnt_idgr_ID не передано, оно может быть получено от устройства.
Если не было передано значение idnt_Name, то оно будет получено из idnt_Code.
У устройства с программным модулем на панели «Настройка» должны быть заполнены поля Группа для новых идентификаторов и Тип для новых идентификаторов.
GET
/get-identifier-id
{ "idnt_ID": "670BF67D-5CA1-D949-A7A9-9BC79AA30EA3" }
Код идентификатора. Обязательный параметр.
Тип идентификатора. Обязательный параметр.
Тип может быть поднят из устройства, если не передан, но если не будет найден и в устройстве, то вернется ошибка.
http://localhost:8090/get-identifier-id?code=123&type=CC5A66E6-6062-F147-AD9B-49F1F299EBDB
Ответ:
{ "idnt_ID": "E90648DF-5F4A-1A4F-990A-E4BF2B09FA2E" }
Если введенные code и type не будут найдены - вернется HttpStatus 404
с ошибкой.
GET, POST
/custom-execute
Имя запроса как указано в параметрах устройства, список параметров, если есть, в формате.
parameter1=value1¶meter2=value2...
Имена параметров запроса должны полностью соответствовать параметрам % в самом запросе.
Пример вызова
http://127.0.0.1:8090/custom-execute/MyQuery?parameter1=value1¶meter2=value2
application/json
, структура соответствует данным, поднимаемым запросом.
В Tillypad API реализован новый метод . У устройства добавлен параметр, в котором можно прописать свой метод.
В Tillypad API добавлен метод, который возвращает разумные, с нашей точки зрения, данные из Tillypad, но Клиент может обращаться к нему не напрямую, а через посредника, которого, например, разработает Дилер.
Этот посредник получит данные по этому запросу через наш API, добавит свои данные и вернет ответ в том виде, который нужен Клиенту.
Для случаев, когда нужно получить данные из Tillypad и передать их в какую-то другую базу (программное обеспечение), в том числе, когда данные в стороннем программном обеспечении сливаются из различных источников.
Например, надо добавить метод POST.
http://127.0.0.1:8090/custom-execute/MyQuery?parameter1=value1
Любой http-тип подходит, в том числе POST. Не обязательно добавлять external-процедуру в базу. Можно просто задать ее текст в ini-файле QueryExecutor
(в параметрах устройства ).
Для приведенного примера можно добавить в ini-файл:
CustomQueries = ( Item = ( Name = 'MyQuery' Streams = 'main' SQL = 'SELECT * FROM MenuItems WHERE mitm_ID=%value1' ) )
Если вы хотите добавить в базу данных external-процедуру, например, MyProc
, нужно создать что-то типа:
CREATE PROCEDURE MyProc_External ... ...
В параметре SQL будет просто:
SQL = 'EXEC MyProc_External %value1'