RU
EN
ГЛАВНАЯ СТРАНИЦА

Дополнительно

Структура заметки

ПолеОбязательноеЗаполняется на сервереЗаполняется на клиенте

note_ID

note_nttp_ID

note_Item_ID

note_obj_ID

note_tpsyso_ID

note_Date

note_Value

Пример

{ 
... 
, 
"notes": [ 
            { 
                "note_ID": "8A7AE96D-9E76-1D4F-B1A9-BD64CCDB29A2", 
                "note_nttp_ID": "15A75D5C-C7AB-8347-8FAC-60BF9E9EAB4D", 
                "note_Item_ID": "670BF67D-5CA1-D949-A7A9-9BC79AA30EA3", 
                "note_obj_ID": "670BF67D-5CA1-D949-A7A9-9BC79AA30EA3", 
                "note_tpsyso_ID": "23BD8E43-AABC-4EB1-AA47-0DECF358F51F", 
                "note_Date": "2017-08-09T11:27:55", 
                "note_Value": { 
                    "value": "ф", 
                    "type": "string"  
                } 
            } 
        ] 
}

Поле note_Value является полем типа SQL_VARIANT, поэтому чтобы не потерять тип, записывается в json тексте в составном виде:

note_Value": { 
    "value": "значение", 
    "type": "string|boolean|integer|guid|datetime|ansistring|blob|double"  
  } 

Значение value всегда записывается в кавычках, в формате своего типа.

Тип**

Пример

string

"строка"

boolean

"true"

integer

"5"

guid

"E11124FB-1E31-5C4D-8CCC-7D82810DD1FE"

datetime

"2017-07-28T14:38:19"

ansistring

"строка"

blob

"0102FF"

double

"0.5"

Тайм-аут выполнения запроса

Для избежания "висящих" запросов если отсутствует соединение с сервером приложений добавлен параметр тайм-аута ожидания выполнения запроса.

Его можно указать в миллисекундах, секундах, минутах, часах. Как только это время будет исчерпано, попытка отправить запрос будет остановлена, и будет возвращена ошибка:

    "timestamp": 1522930136820,
    "status": 503,
    "error": "Service Unavailable",
    "exception": "com.tillypad.exceptions.RequestTimeoutException",
    "message": "Превышено время ожидания ответа от сервера (запрос не выполнен)",
    "path": "/post-guest"
    

Если же запрос был отправлен, а ответ еще не получен, но во время выполнения запроса произошел разрыв соединения с сервером, то вернется ошибка:

    "timestamp": 1522930447404,
    "status": 500,
    "error": "Internal Server Error",
    "exception": "com.tillypad.exceptions.RequestResultUnknownException",
    "message": "Во время выполнения запроса было разорвано соединение, результат запроса неизвестен",
    "path": "/post-guest"
    

Кеширование POST-запросов

Все запросы, изменяющие состояние базы, дополняются необязательным параметром transaction.

transaction=<id>

Этот параметр предотвращает повторную отправку одного и того же запроса (нежелательного дублирования). Пока запрос имеет определенный transaction - он будет выполнен только один раз, а далее будет возвращен закешированный результат (в случае с /post-guest, /post-client)

Список запросов:

  • /post-guest

  • /post-client

  • /update-client

  • /post-discount-point-operations

  • /post-purse-operations /pay-guest и так далее.

Пример

/post-guest?transaction=9FC5499D-D003-6443-8987-8CE6474E14B1

Что нужно для стартовой настройки

  • Параметры подключения к серверу приложений: ip-адрес сервера приложений, номер порта.

  • Логин-пароль пользователя Тиллипад

  • FB-лицензии

GUID объектов из сегмента, необходимых для работы с API

dev_ID

POS кол-центра (с подключенным геокодером, если предполагается геокодирование).

dvsn_ID

Подразделение, используемое по умолчанию.

На него будут регистрироваться гостевые счета счета, если gest_dvsn_ID не будет передан.

usr_ID

Пользователь по умолчанию. Будет указан как сотрудник в счетах, если gest_usr_ID не будет передан.

lggr_ID

Языковая группа по умолчанию.

clgr_ID

Группа для новых клиентов доставки.

nttp_ID

Заметка в для передачи в нее заявленной суммы баллов (скидка на счет). Необязательная.

nttp_ID

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

Процедуры после апгрейда

Важно

Если у вас релиз ниже чем 10.1.9, обратитесь в службу поддержки для получения пакета с процедурами.