Редактирование постоянного клиента

Тип

PUT

Вызов

/update-client

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

Ничего не возвращает

Параметры

В секции BODY запроса атрибуты постоянного клиента и их значения в иерархическом виде. В секции HEADER необходимо указать "Content-Type: application/json".

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

curl \
  -X PUT \
  -H "Content-Type: application/json" \
  -d @client_in.json \  
  --url "http://89.22.216.169:8090/update-client"

: client_in.json – имя файла с редактируемыми полями из содержимого постоянного клиента.

Пример редактирования постоянного клиента

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

{    
"clnt_ID": "E7F9298A-613D-6241-BA4B-0AA0A1134B6E", 
    "people": { 
    "pepl_ID": "857950A1-0CD6-794F-8F51-74646C2487F8", 
        "pepl_FirstName": "Иван", 
        "pepl_SecondName": "Харитонов", 
        "pepl_EMail": "xaritonov@yandex.ru", 
        "pepl_PhoneCell": "+7(921)593-16-58"  
    }, 
    "clientPhones": [ 
      { 
        "clph_ID": "A886CB42-5598-8543-888B-5B37EA0A12B7", 
        "clph_Phone": "+7(921)593-16-58"  
      } 
    ], 
    "addresses": [ 
    { 
    "addr_ID": "0B944627-F3CA-F741-B545-D5B98B8F4710", 
    "addr_XML": "Санкт-ПетербургЛенина102121224комментарий" 
    } 
  ] 
}

Соглашения

Для редактирования нужного клиента обязателен clnt_ID существующего в базе клиента, если такого ID нет, или clnt_ID вообще не был введен, то будет возвращена ошибка.

{ 
    "timestamp": 1510317018403, 
    "status": 500, 
    "error": "Internal Server Error", 
    "exception": "com.tillypad.lib.client.SQLException", 
    "message": "[Microsoft][ODBC SQL Server Driver][SQL Server]Значение параметра clnt_ID не заполнено или не найдено",
    "path": "/update-client", 
    "errorcode": 135531 
}

Для редактирования клиента достаточно отправить только редактируемые поля, а для редактирования его параметров People, ClientPhones, Addresses нужны их ID (ведь телефонов и адресов может быть несколько, а People – это редактирование персональных данных, привязанных к клиенту).

"clientPhones": [
    {
    "clph_ID": "A886CB42-5598-8543-888B-5B37EA0A12B7",
        "clph_Phone": "+7(921)593-16-58" 
    }
 ],
"addresses": [
    {
    "addr_ID": "0B944627-F3CA-F741-B545-D5B98B8F4710",
    "addr_XML": "<Address><Village Caption="Населенный пункт" Key="True">Санкт-Петербург</Village><Street Caption="Улица" Key="True">Ленина</Street><House Caption="Дом" Key="True">10</House><Building Caption="Корпус" Key="True">2</Building><Apartment Caption="Квартира" Key="True">12</Apartment><Entrance Caption="Подъезд">1</Entrance><Floor Caption="Этаж">2</Floor><Intercom Caption="Домофон">24</Intercom><Comment Caption="Комментарий">комментарий</Comment></Address>" 

    }
 ]

Для добавления нового телефона – добавить только новый телефон (clph_Phone).

Предупреждение

Телефон добавить можно, а привязать адрес (addr_XML) – нет.

В текущей реализации API добавление адреса не реализовано. Можно только изменять существующий адрес.