Сервис без авторизации, работающий только внутри банка и предназначен для получения информации о клиенте iSimpleBank 2.0, который инициализировал канал в чате.

Сервис доступен с версий iSimpleBank 2.0.14.632

Передача сообщения

GET запрос на сервер, вида:

http://[host]:[port]/rest/chat/client/id/{token}

Входные параметры в URL

Параметр

Обязательность

Описание

token

да

Токен клиента, зашифроанный 1024-х битным RSA ключом

Выходные параметры

В теле ответа application/json, который в случае успеха содержит набор полей: 

Параметр

ТипОбязательность

Описание

clientБлок полейдаблок полей клиента физического лица (блок внутри основного элемента)

id

Longда

Идентификатор клиента в iSimpleBank 2.0

name

Stringда

ФИО клиента

surnameStringдаФамилия
firstnameStringдаИмя
patronymicStringдаОтчество
typeLongдаКод типа клиента
enabledBooleanда

Обслуживание клиента разрешено

birthDateDateнетДата рождения
extRefStringнетИдентификатор клиента в АБС
cardRefStringнетИдентификатор клиента в карточном бэк

bankBranch

Блок полейнетблок полей подразделения банка клиента (блок внутри блока client)

id

Longнет

Идентификатор подразделения банка в iSimpleBank 2.0

extRefStringнетИдентификатор в АБС подразделения банка
bikStringнетБИК подразделения банка

name

Stringнет

Наименование подразделения банка

crmURLStringнетURL CRM (Url чата для клиента)
accountListМассив объектов AccountInfoнетсписок счетов

companyList

Параметр

Тип

Описание

idLongИдентификатор организации в iSimpleBank 2.0
nameStringНаименование организации
typeLongКод типа организации
enabledBooleanОбслуживание организации разрешено
extRefStringКод клиента в АБС
innStringИНН
kppStringКПП
residentBooleanпризнак "Нерезидент"
phoneStringТелефоны
shortNameStringСокращенное наименование
internationalNameStringМеждународное наименование
ogrnStringОГРН
ogrnDateDateДата ОГРН
internationalAddressString
Итоговый полный международный адрес
accountListМассив объект ов AccountInfo


Массив объектовнет

блок полей списка организаций (блок внутри основного элемента)

реализовано в рамках IS-9609 - Сервис ЧАТа для сотрудников юр. лица. Не возвращается информация о клиенте по токену ИСПОЛНЕН


Объект AccountInfo

Параметр

Тип

Описание

accountTypeCode

String

Код типа счета

accountTypeCaption

String

Наименование типа счета

currCodeStringКод валюты
currCodeIsoStringISO-код валюты
accountStringНомер счета
contractStringДоговор
branchNameStringФилиал банка


а в случае ошибки содержит набор полей

Параметр

ТипОбязательность

Описание

errorCode

Stringда

Код ошибки

errorText

Stringнет

Текст ошибки

stackTraceString[]нетСтектрейс внутренней ошибки

Возможные коды ошибок (errorCode)

Код

Описание

1000Невалидный токен
1001Пользователь не найден
1002Не настроено подключение к БД (настраивается в файле config.json)
1003Истек срок действия токена (с версии iSimpleChatService-0.1.0)

Пример 1 успешного вызова сервиса

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/v0201a57974242d0146c280560ab0693f7550b2dbff1e33776f7505180eb4c9d7d2938de42bb49c2b9adec4dea68c5af0f037b3a0a433cafdb6542103b9093a39a7c3561f3a2a56627f74fb7893f4f03a3bee494bc98dbebe38459c68beb9eb43f2288c1203c3c861ab79bc90399e6ebbd8ce8bc5aace84bff09df0c316e5225486
 
RESPONSE 
    HTTP/1.1 200 OK
    Answer data:

{"client":{

"id":"1064775",

"name":"Давыдов Юрий Викторович",

"surname":"Давыдов",

"firstname":"Юрий",

"patronymic":"Викторович",

"birthDate":"1976-03-31",

"type":"0",

"enabled":"true",

"extRef":"1",

"bankBranch":{"id":"720987","extRef":"1","bik":"042809888","name":"ЗАО КБ \"ГЛОБАЛЬНЫЙ РАСЧЕТНЫЙ ЦЕНТР\""}

}}

Пример 2 ошибки вызова сервиса

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/1234567890
 
RESPONSE 
    HTTP/1.1 200 OK
    Answer data:

{"errorCode":"1001","errorText":"Client not found"}

Пример 3 ошибки вызова сервиса

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/1234567890
 
RESPONSE 
    HTTP/1.1 400 BAD_REQUEST
    Answer data:

{"errorCode":"1000","errorText":"Bad client token"}

Пример 4 успешного вызова сервиса с возвратом списка из 2х компаний

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/v0201a57974242d0146...f09df0c316e5225486
 
RESPONSE 
    HTTP/1.1 200 OK
    Answer data:

{
"client": {
"id": "124625",
"name": "Царев Алексей Юрьевич",
"surname": "Царев",
"firstname": "Алексей",
"patronymic": "Юрьевич",
"birthDate": "1973-09-02",
"type": "2",
"enabled": "false"
},
"companyList": [{
"id": "225760",
"name": "ООО "УралСтройМаш"",
"extRef": "561",
"inn": "7701028744",
"kpp": "770001001",
"resident": "true",
"phone": "+79093342334",
"shortName": "ОАО "ЛИГА"",
"internationalName": "LIGA JSC",
"ogrn": "1057703026633",
"ogrnDate": "2005-02-11"
},
{
"id": "124612",
"name": "ОАО "Капитолий"",
"extRef": "560",
"inn": "7701058541",
"kpp": "770001001",
"resident": "true",
"phone": "123-34-45",
"shortName": "ОАО "Капитолий"",
"internationalName": "CAPITOLIY JSC",
"ogrn": "2801283419468",
"internationalAddress": "",
"regAddress": ""
}],
}


Пример 5 успешного вызова сервиса с возвратом списка из 1ой компании

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/v0201a57974242d0146...f09df0c316e5225486
 
RESPONSE 
    HTTP/1.1 200 OK
    Answer data:

{
"client": {
"id": "124625",
"name": "Царев Алексей Юрьевич",
"surname": "Царев",
"firstname": "Алексей",
"patronymic": "Юрьевич",
"birthDate": "1973-09-02",
"type": "2",
"enabled": "false"
},
"companyList": [{
"id": "124612",
"name": "ОАО "Капитолий"",
"extRef": "560",
"inn": "7701058541",
"kpp": "770001001",
"resident": "true",
"phone": "123-34-45",
"shortName": "ОАО "Капитолий"",
"internationalName": "CAPITOLIY JSC",
"ogrn": "2801283419468",
"internationalAddress": "",
"regAddress": ""
}],
}


Пример 6 ошибки вызова сервиса

REQUEST 
    GET http://127.0.0.1:8080/rest/chat/client/id/v0201a57974242d0146...f09df0c316e5225486
 
RESPONSE 
    HTTP/1.1 401 UNAUTHORIZED
    Answer data:

{"errorCode":"1003","errorText":"Client token expired"}

  • No labels