Участникам
Основная цель АИС «Marketplace»- поддержка цифровизации финансовых продуктов и услуг для малых и средних предприятий (МСП) и граждан. Система призвана, с одной стороны, обеспечить равный доступ пользователей услуг к финансовому рынку, с другой сформировать предпосылки для развития конкурентной среды и оптимизации финансовых сервисов. Среди преимуществ Системы является улучшение ситуации с финансовой доступностью как физических лиц, так и юридических, в частности, малый и средний бизнес за счет снятия географических ограничений и упрощения процедур. При этом пользователи получат дистанционный доступ к финансовым услугам в режиме 24/7 и широкую линейку финансовых продуктов. Продуктовый ассортимент будет включать банковские вклады, государственные и корпоративные облигации, страхование и ипотечные кредиты.
Инфраструктура системы подразумевает систему, которая функционирует по принципу «plug&play», т.е. подключайся и начинай сразу же работать и будет объединять таких участников как:
- Электронные платформы. Площадки, на которых взаимодействуют финансовые организации и клиенты для заключения сделок. Задача платформы состоит в автоматизации взаимодействия сторон и обеспечении удобства совершения финансовых транзакций;
- Поставщики финансовых продуктов и услуг. Это банки, микрофинансовые и страховые компании, эмитенты корпоративных и государственных облигаций и др.;
- Витрины-агрегаторы. Интернет-ресурсы и мобильные приложения, предоставляющие клиенту возможность выбора финансового продукта посредством систематизации и визуализации его характеристик. Витрина призвана обеспечить представление параметров финансового продукта (срок, процентная ставка, рейтинг и т.д.);
- Боты. Автоматизированные консультанты по финансовым продуктам и услугам при заключении и исполнении сделок.
Инфраструктура системы будет интегрирована с платформой для удаленной идентификации, что позволит перевести финансовые услуги в цифровую среду и повысить уровень их доступности для потребителей.
Описание API FinMarket
|
GetServices |
|
|
|
|
|
Описание: |
Запрос на получение описание всех шаблонов сервисов |
|
|
В случае отсутствия идентификации пользователя, запросившего данные, системой будут выданы информационные сервисы.
При наличии идентификации в ответ будут высланы сервисы, к которым данный пользователь имеет доступ, роль которого настроена администратором СБК |
|
Тип запроса: |
POST |
|
URL: |
https://sbk.finmarket.kg/api/index.php |
|
№ |
Headers (Шапка запроса) |
||
|
1) |
Content-Type |
application/x-www-form-urlencoded |
не обязательное |
|
2) |
Access-Key |
HfCDouv9EgXEbmz |
не обязательное |
|
|
|
|
|
|
|
|
|
|
|
1) |
userid |
userid |
не обязательное |
|
2) |
operation |
GetServices |
обязательное |
|
Пример положительного ответа: |
|
|
|
|
|
"success": true, |
|
|
"result":{ |
|
|
|
" data ":[ Передается массив экземпляров следующего описания |
|
Наименование |
Тип |
Описание |
|
SERVICE_ID |
Число |
Системный номер сервиса |
|
SERVICE_NAME |
Текст |
Наименование сервиса. Например, LOAN , DEPOSIT , MORTGAGE , INSURANCE , и т.д. |
|
TYPE |
Текст |
Тип сервиса (Информационный, Персональный, Служебный) |
|
CATEGORY |
Текст |
Категория сервиса (группировка по поставщикам данных) |
|
KIND |
Текст |
Вид сервиса, разделение по направлениям |
|
SUBKIND |
Текст |
Подвид сервиса, разделения по под направлениям |
|
VALID_FROM_DATE |
Дата |
Дата начала действия сервиса |
|
VALID_UNTIL_DATE |
Дата |
Дата окончания действия сервиса |
|
ROUTE_TYPE |
Текст |
Тип маршрутизации (публикация- sub , запрос- reqrep ) |
|
ALIVE_PERIOD |
Число |
Время в секундах, указывающее на длительность действия сообщения с даты времени создания |
|
DESCRIPTION |
Текст |
Описание сервиса |
|
ACTION_SERVICE |
Число |
Системный номер сервиса, который может продолжить маршрутизацию |
|
REPLY_SERVICE |
Число |
Системный номер сервиса, который является ответом на запрос |
|
|
|
Описание полей шаблона |
|
TEXT_1 |
Текст |
Описание поля |
|
TEXT_2 |
Текст |
Описание поля |
|
… |
Текст |
Описание поля |
|
TEXT_30 |
Текст |
Описание поля |
|
NUMBER_1 |
Текст |
Описание поля |
|
NUMBER_2 |
Текст |
Описание поля |
|
… |
Текст |
Описание поля |
|
NUMBER_20 |
Текст |
Описание поля |
|
DATE_1 |
Текст |
Описание поля |
|
DATE_2 |
Текст |
Описание поля |
|
… |
Текст |
Описание поля |
|
DATE_20 |
Текст |
Описание поля |
|
"DETAILS":[ |
|
Описание вложенных массивов |
|
DETAILS_1 |
Текст |
Наименование вложенного массива |
|
TEXT_1 |
Текст |
Описание поля |
|
… |
Текст |
Описание поля |
|
TEXT_10 |
Текст |
Описание поля |
|
NUMBER_1 |
Текст |
Описание поля |
|
… |
Текст |
Описание поля |
|
NUMBER_10 |
Текст |
Описание поля |
|
Пример ответа об ошибке - для всех запросов, схема схожа |
||
|
|
|
Пример значения |
|
|
"success": false, |
|
|
|
"error":"no parameters" |
no parameters, no such request |
|
GetData |
||
|
|
|
|
|
Описание: |
Получение публикации или запросы в соответствии с конкретным сервисом |
|
|
|
В случае отсутствия идентификации пользователя, запросившего данные, системой будет выдано сообщение только информационного типа.
При наличии идентификации в ответ будут высланы данные сервиса, к которому данный пользователь имеет доступ, роль которого настроена администратором СБК |
|
|
Тип запроса: |
POST |
|
|
URL: |
||
|
№ |
Headers (Шапка запроса) |
|||
|
1) |
Content-Type |
application/x-www-form-urlencoded |
|
не обязательное |
|
2) |
Access-Key |
HfCDouv9EgXEbmz |
|
не обязательное |
|
|
|
|
|
|
|
|
|
|
|
|
|
1) |
userid |
userid |
|
не обязательное |
|
2) |
operation |
GetData |
|
обязательное |
|
3) |
service_id |
service_id |
Номер шаблона |
обязательное |
|
4) |
date_from |
По умолчанию текущая дата |
Возможность получения данных по периоду |
не обязательное |
|
5) |
date_until |
По умолчанию текущая дата |
не обязательное |
|
|
Пример положительного ответа: |
|
|
|
|
|
"success": true, |
|
|
"result":{ |
|
|
|
" data ":[ Передается массив экземпляров следующего описания |
|
Наименование |
Тип |
Описание |
|
MESSAGE_ID |
Число |
Системный номер сообщения |
|
MEMBER_NAME |
Текст |
Наименование участника опубликовавшего сообщение |
|
MEMBER_ID |
Текст |
ID участника опубликовавшего сообщение |
|
STATUS |
Текст |
Статус сообщения (активно, не активно) |
|
STATE |
Текст |
Состояние сообщения (отправлен, доставлен, отвечен, нет ответа) |
|
VALID_FROM_DATE |
Дата |
Дата начала действия сервиса |
|
VALID_UNTIL_DATE |
Дата |
Дата окончания действия сервиса |
|
|
|
Заполнение полей в соответствии с шаблоном |
|
TEXT_1 |
Текст |
Значение |
|
TEXT_2 |
Текст |
Значение |
|
… |
Текст |
Значение |
|
TEXT_30 |
Текст |
Значение |
|
NUMBER_1 |
Число |
Значение |
|
NUMBER_2 |
Число |
Значение |
|
… |
Число |
Значение |
|
NUMBER_20 |
Число |
Значение |
|
DATE_1 |
Дата_время |
Значение |
|
DATE_2 |
Дата_время |
Значение |
|
… |
Дата_время |
Значение |
|
DATE_20 |
Дата_время |
Значение |
|
"DETAILS":[ |
|
Значения во вложенных массивах |
|
DETAILS_1 |
Текст |
Наименование вложенного массива |
|
TEXT_1 |
Текст |
Значение |
|
… |
Текст |
Значение |
|
TEXT_10 |
Текст |
Значение |
|
NUMBER_1 |
Число |
Значение |
|
… |
Число |
Значение |
|
NUMBER_10 |
Число |
Значение |
|
DATE_1 |
Дата_время |
Значение |
|
… |
Дата_время |
Значение |
|
DATE_10 |
Дата_время |
Значение |
|
PushData |
||
|
|
|
|
|
Описание: |
Публикация сообщения или ответа на запрос |
|
|
|
Доступ на публикацию имеют только участники платформы (партнеры СБК) |
|
|
Тип запроса: |
POST |
|
|
URL: |
||
|
№ |
Headers (Шапка запроса) |
|||
|
1) |
Content-Type |
application/x-www-form-urlencoded |
|
не обязательное |
|
2) |
Access-Key |
HfCDouv9EgXEbmz |
|
обязательное |
|
|
|
|
|
|
|
|
|
|
|
|
|
1) |
userid |
userid |
|
обязательное |
|
2) |
operation |
PushData |
|
обязательное |
|
3) |
service_id |
service_id |
Номер шаблона |
обязательное |
|
Пример положительного ответа: |
|
|
|
|
|
"success": true, |
|
|
"result":{ |
|
|
|
" data ":[ Передается массив экземпляров следующего описания |
|
Наименование |
Тип |
Описание |
|
MEMBER_ID |
Текст |
ID получателя. Может быть пустым. (в случае общей публикации остается пустым) |
|
VALID_FROM_DATE |
Дата |
Дата начала действия сервиса. Может быть пустым. (По умолчанию текущая дата_время) |
|
VALID_UNTIL_DATE |
Дата |
Дата окончания действия сервиса. По умолчанию текущая дата_время плюс время жизни, указанное в шаблоне |
|
REPLY_TO |
Число |
Номер запроса, в случае если это сервис ответа. Может быть пустым. |
|
|
|
Заполнение полей в соответствии с шаблоном |
|
TEXT_1 |
Текст |
Значение |
|
TEXT_2 |
Текст |
Значение |
|
… |
Текст |
Значение |
|
TEXT_30 |
Текст |
Значение |
|
NUMBER_1 |
Число |
Значение |
|
NUMBER_2 |
Число |
Значение |
|
… |
Число |
Значение |
|
NUMBER_20 |
Число |
Значение |
|
DATE_1 |
Дата_время |
Значение |
|
DATE_2 |
Дата_время |
Значение |
|
… |
Дата_время |
Значение |
|
DATE_20 |
Дата_время |
Значение |
|
"DETAILS":[ |
|
Значения во вложенных массивах |
|
DETAILS_1 |
Текст |
Наименование вложенного массива |
|
TEXT_1 |
Текст |
Значение |
|
… |
Текст |
Значение |
|
TEXT_10 |
Текст |
Значение |
|
NUMBER_1 |
Число |
Значение |
|
… |
Число |
Значение |
|
NUMBER_10 |
Число |
Значение |
|
DATE_1 |
Дата_время |
Значение |
|
… |
Дата_время |
Значение |
|
DATE_10 |
Дата_время |
Значение |
|
GetMembers |
|
|
|
|
|
Описание: |
Получение участников платформы |
|
|
Список формируется в зависимости от роли и типа сервиса. Передаются участники на подписку или запрос-ответы которых имеет доступ текущая роль |
|
|
|
|
Тип запроса: |
POST |
|
URL: |
|
|
№ |
Headers (Шапка запроса) |
|||
|
1) |
Content-Type |
application/x-www-form-urlencoded |
|
не обязательное |
|
2) |
Access-Key |
HfCDouv9EgXEbmz |
|
не обязательное |
|
|
|
|
|
|
|
|
|
|
|
|
|
1) |
userid |
userid |
|
не обязательное |
|
2) |
operation |
GetMembers |
|
обязательное |
|
3) |
service_id |
service_id |
|
обязательное |
|
|
|
|
|
|
|
Пример положительного ответа: |
|
|
|
|
|
"success": true, |
|
|
"result":{ |
|
|
|
" data ":[ Передается массив экземпляров следующего описания |
|
Наименование |
Тип |
Описание |
|
MEMBER_ID |
Число |
Системный номер участника |
|
MEMBER_NAME |
Текст |
Наименование участника |
|
STATUS |
Текст |
Статус участника (активен, не доступен) |
