/api/v2/bpm/step
Универсальный шаговый метод. Самый важный элемент для работы мобильных приложений (процессов) построенных с помощью BPMS
Query Parameters
- nodeWithTokens boolean
Если возникнет необходимость в выпуске новых токенов, будут выпущены новые токены + будет добавлен ответный шаг, как если бы запрос уже был с новыми токенами
Example: false - isCastTypes boolean
Влияет на то, что настройки ноды в ответе будут приходить в соответствии с их типом. Если в параметре не указан тип, это будет строка. Если приведение типа не удается, это будет строка
Example: false - currentScreen boolean
Когда приложение использует кэширование экрана, оно всегда имеет следующий экран, передаваемый из предыдущих шагов. Если установлено значение true, вместо следующего экрана будет отображаться только его id
Example: true - autoComponents boolean
Параметр определяет, будет ли информация о компоненте извлекаться во время перехода между экранами. Это значительно замедляет переход. Приложение должно быть настроено на работу с компонентами
Example: true - nextNodes boolean
Этот параметр определяет, будут ли экраны, следующие за целевым экраном, включены в ответ
Example: false
- application/json
Request Body
device object
Информация об устройстве, обязательно содержащая ключ идентификатора. Остальные параметры могут быть произвольными
id stringPossible values:
non-empty
and<= 255 characters
Информация об устройстве. Ключ идентификатора внутри обязателен. Приложение должно гарантировать, что оно уникально для каждого пользователя
name stringPossible values:
non-empty
and<= 255 characters
Краткое наименование устройства
- projectId string
Possible values:
non-empty
and<= 255 characters
Несмотря на название поля, пока что здесь фигурирует наименование проекта
- lang string
Possible values:
non-empty
and<= 255 characters
Наименование языка (en, ru и т.д)
- screenId int64
ID текущего экрана (ноды типа 'экран') необходим для позиционирования действия пользователя
- destination string
Possible values:
non-empty
and<= 255 characters
Поле, содержащее команду для осуществления перехода. Принимает два значения: 'next' и 'previous'. Этот параметр используется, когда отсутствует элемент и идентификатор события, в этом случае метод будет проверять переходы, которые не связаны с конкретными элементами
- eventId int64
ID события, которое может является триггером для выполнения перехода
- elementId int64
ID любого элемента экрана (ноды типа 'поле'). Используется, если событие на экране относится к определенному элементу и содержит действие 'goto'
- fastEnter boolean
Флаг свидетельствует о состоянии сессии. Будет ли осуществлен быстрый вход в приложение или придется начать со стартового экрана. Подробности в разделе 'step'
- nodeData object
Объект содержащий данные необходимые для передачи на сервер, например, данные с экрана пользователя. Данные с ключей будут сохранены в одноименных пользовательских переменных
- 200
- 403
OK
- application/json
- Schema
- Example (from schema)
- example-0
- example-1
- example-2
Schema
- object
{}
200_without_token
{
"auth": {
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzA2OTc1MTA0LCJpYXQiOjE3MDY5NzQ5MjQsImp0aSI6IjA1Y2RjY2Y5ODMyZjQ1ODM4YzI4NWU3NDcwMzM2NDI4IiwiaWRfdXNlciI6MjIxMDYzM30.QTtvkRWRfJkDazx6Gv4Igq7BQhq0VPyHaCsJ6rS27S0",
"refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTcwNjk3NjcyNCwiaWF0IjoxNzA2OTc0OTI0LCJqdGkiOiJiMGEwMWZjZTRlOWU0YTExYTcwYzc5MDBlY2NmMmFjMSIsImlkX3VzZXIiOjIyMTA2MzN9.qJMjsfhn1XZcYHGE2Jpac3bWZq5wFD750ZxTKvwk3-8"
},
"preparingsTime": 0.086
}
200_old
{
"node": {
"id": 5261,
"name": "identification",
"title": "Identification",
"screens": [
{
"id": 5262,
"name": "identification.mobileNumber.screen_1_deprecated_1680298884",
"title": "main",
"nodeType": "screen",
"nodeFields": [
{
"id": 12585,
"name": "identification.mobileNumber.screen_1.block.1",
"order": 1,
"nodeType": "block",
"properties": {
"visibility": true,
"align": "center",
"text": "<span class='font-text-h2'>Verify your phone number</span>"
}
},
{
"id": 12586,
"name": "identification.mobileNumber.screen_1.block.2",
"order": 2,
"nodeType": "block",
"properties": {
"visibility": true,
"align": "center",
"text": "<span class='font-text-body'><span class='color-text-minor-first'>This is a one-time OTP verification. Promise!</span></span>"
}
},
{
"id": 12588,
"name": "identification.mobileNumber.screen_1.block.4",
"order": 4,
"nodeType": "block",
"properties": {
"visibility": true,
"align": "left",
"text": "<span class='font-text-interlinear'><span class='color-text-minor-second'>Make sure this is the phone number linked to┬аyour Aadhaar!</span></span>"
}
},
{
"id": 12589,
"name": "identification.mobileNumber.screen_1.block.5",
"order": 5,
"nodeType": "block",
"properties": {
"visibility": true,
"align": "left",
"text": "<span class='font-text-small'>By continuing, I agree to <span class='url' href=\"https://example.com\" rel=\"noopener noreferrer\" target=\"_blank\"><span class='mod-text-underline'>Viva's Terms and Conditions</span></span> and <span class='url' href=\"https://example.com\" rel=\"noopener noreferrer\" target=\"_blank\"><span class='mod-text-underline'>Privacy Policy</span></span></span>"
}
},
{
"id": 12590,
"name": "identification.mobileNumber.screen_1.topBar.None",
"order": null,
"nodeType": "topBar",
"properties": {
"widget_preset": "1270"
}
},
{
"id": 12591,
"name": "identification.mobileNumber.screen_1.slider.None",
"order": null,
"nodeType": "slider",
"properties": {
"widget_preset": "1282"
}
},
{
"id": 12592,
"name": "identification.mobileNumber.screen_1.button.None",
"order": null,
"nodeType": "button",
"properties": {
"widget_preset": "1273"
}
},
{
"id": 12587,
"name": "identification.mobileNumber.screen_1.input.3",
"order": 3,
"nodeType": "input",
"properties": {
"visibility": true,
"security": false,
"isHidden": false,
"imgUrl": "",
"background": "#F5F7FB",
"strokeColor": "",
"errorStrokeColor": "#E32A5F",
"errorImgUrl": "",
"successStrokeColor": "#43B02A",
"successImgUrl": "",
"regEx": "^[6-9]d{9}$",
"mask": "<span class='font-text-body'><span class='color-text-minor-second'>+(91)-___-___-__</span></span>",
"label": "<span class='font-text-interlinear'><span class='color-text-minor-second'>Phone number:</span></span>",
"text": "<span class='font-text-body'></span>",
"placeholder": "<span class='font-text-body'><span class='color-text-minor-second'>Phone number: +91</span></span>",
"errorIndicator": false,
"errorText": "<span class='font-text-body'><span class='color-text-accent-error'>Please enter your phone number to proceed</span></span>",
"disable": false,
"disableColor": ""
}
}
],
"widgets": [
{
"id": 2890,
"name": "topBar",
"presetName": "logo+help",
"nodeType": "widget",
"nodeFields": [
{
"id": 4182,
"name": "image",
"order": 1,
"nodeType": "image",
"properties": {
"visibility": true,
"imageUrl": ""
}
},
{
"id": 4183,
"name": "langSelect",
"order": 2,
"nodeType": "langSelect",
"properties": {
"visibility": false,
"imageUrl": "",
"text": "ENG",
"data": "['ENG', 'рд╣рд┐рдВрджреА']"
}
},
{
"id": 4184,
"name": "button.image",
"order": 3,
"nodeType": "button.image",
"properties": {
"visibility": true,
"text": "",
"imageUrl": "",
"url": ""
}
}
]
},
{
"id": 3275,
"name": "slider",
"presetName": "sliderProductBenefits",
"nodeType": "widget",
"nodeFields": [
{
"id": 2921,
"name": "slider",
"order": 1,
"nodeType": "slider",
"properties": {
"visibility": true,
"background": "#E9F6E5",
"color╨бircle": "#E9ECF8",
"activeColor╨бircle": "#B51ACE",
"cards": "[{'text': '<span class = тАШfont-text-h3тАЩ>Grace period up to 51 days</span>\\n <span class = тАШfont-text-bodyтАЩ>free, without hidden feesand overpayments</span>', 'imageUrl': 'url'}, {'text': '<span class = тАШfont-text-bodyтАЩ></span>', 'imageUrl': 'url'}, {'text': '<span class = тАШfont-text-h3тАЩ></span>', 'imageUrl': 'url'}]"
}
}
]
},
{
"id": 3011,
"name": "button",
"presetName": "button+next+gradient",
"nodeType": "widget",
"nodeFields": [
{
"id": 7684,
"name": "button.main",
"order": 1,
"nodeType": "button.main",
"properties": {
"align": "center",
"visibility": true,
"color": "{'gradient' : { 'deg': 93.21}, 'value' : [ {'color' : '#A92DD2', 'weight' : '11.61%'}, {'color' : '#9747FF', 'weight' : '24.44%'}, {'color' : '#339C89', 'weight' : '64.47%'}, {'color' : '#43B02A', 'weight' : '92.93%'}] }",
"strokeColor": "",
"text": "<span class = тАШfont-text-btnтАЩ><span class = тАШcolor-text-light-firstтАЩ>Next</span></span>",
"url": "next"
}
}
]
}
],
"properties": {}
}
],
"widgets": [],
"properties": {}
}
}
200_full
{
"node": {
"id": 1038321,
"name": "permissions",
"title": "Permissions",
"screens": [
{
"id": 1038322,
"name": "permissions.screen.1",
"title": "main",
"nodeType": "screen",
"properties": {},
"nodeFields": [
{
"id": 1038324,
"name": "permissions.screen.1.block.1",
"nodeType": "block",
"properties": {
"visibility": "true",
"text": "<span class='font-text-h2'>Permissions</span>",
"align": "left"
}
},
{
"id": 1038323,
"name": "topBar.centerLogo",
"title": "top bar app",
"nodeType": "widget",
"properties": {
"visibility": "true"
},
"nodeFields": [
{
"id": 1038334,
"name": "topBar.centerLogo.button.image.1",
"nodeType": "button.image",
"properties": {
"imageUrl": "media/55/02/55025096cb35ea0453b0811dab56669c.png",
"visibility": "true",
"action": "previous",
"text": "",
"align": "right"
}
},
{
"id": 1038335,
"name": "topBar.centerLogo.image.2",
"nodeType": "image",
"properties": {
"imageUrl": "media/27/cd/27cd2ff0809eb7707c0aa0d67a2dc14f.png",
"visibility": "true"
}
},
{
"id": 1038336,
"name": "topBar.centerLogo.langSelect.3",
"nodeType": "langSelect",
"properties": {
"imageUrl": "",
"data": "[\"ENG\", \"हिंदी\"]",
"visibility": "false",
"text": "ENG"
}
},
{
"id": 1038337,
"name": "topBar.centerLogo.button.image.4",
"nodeType": "button.image",
"properties": {
"imageUrl": "media/7a/16/7a16a4dfa67a691eab1dc8062f602c37.png",
"visibility": "true",
"action": "previous",
"text": "",
"align": "right"
}
}
]
},
{
"id": 1038325,
"name": "permissions.screen.1.block.2",
"nodeType": "block",
"properties": {
"visibility": "true",
"text": "<span class='font-text-body'>For the purpose of credit risk assessment and to facilitate faster loan disbursal, we require the following permissions from you</span>",
"align": "left"
}
},
{
"id": 1038326,
"name": "permissions.screen.1.image.3",
"nodeType": "image",
"properties": {
"imageUrl": "media/c6/a3/c6a384ed0749a9312577e7f3910f1741.png",
"visibility": "false"
}
},
{
"id": 1038327,
"name": "permissions.screen.1.dropDownList.6",
"nodeType": "dropDownList",
"properties": {
"connection": "false",
"imageUrlOpened": "",
"fixed": "true",
"state": "true",
"imageUrl": "media/78/dc/78dcb30093b3e5461f33fbee22228419.png",
"data": "[\"<span class='font-text-small'>We collect and track your device location to provide convenient service to your loan application, reduce the risks associated with your loan application, and provide you with pre-approved and personalized loan offers. It also helps make address verification easier, make better credit risk decisions, and understand the customer (KYC) process.</span>\"]",
"visibility": "true",
"label": "<span class='font-text-h4'>Location</span>",
"connectionColor": "",
"align": "left"
}
},
{
"id": 1038328,
"name": "permissions.screen.1.dropDownList.7",
"nodeType": "dropDownList",
"properties": {
"visibility": "true",
"connection": "false",
"imageUrlOpened": "",
"fixed": "true",
"state": "true",
"imageUrl": "media/7a/f4/7af42508745c6739868a6127c83677ca.png",
"data": "[\"<span class='font-text-small'>Storage permission is required to safely download and store your KYC and other related documents on your phone. You can then easily upload the correct KYC related documents to complete the loan application details and payment process faster. This will ensure a seamless experience while using the app.</span>\"]",
"label": "<span class='font-text-h4'>Storage</span>",
"connectionColor": "",
"align": "left"
}
},
{
"id": 1038329,
"name": "permissions.screen.1.dropDownList.8",
"nodeType": "dropDownList",
"properties": {
"connection": "false",
"imageUrlOpened": "",
"fixed": "true",
"state": "true",
"imageUrl": "media/5f/5e/5f5e6f7ff8420428c28d3180d73c16f7.png",
"data": "[\"<span class='font-text-small'>Access to the camera is required to scan and capture the necessary KYC documents so that the relevant fields can be automatically filled in. To facilitate the KYC process, we need access to the camera so that we can start the KYC process. This permission allows us or our authorized agents to perform KYC on the video and take screenshots of the original legally verified document you provided during the KYC video. Video KYC allows you to complete your KYC digitally seamlessly and efficiently. Videos must be recorded and archived for regulatory purposes, with screenshots of the original document officially verified.</span>\"]",
"visibility": "true",
"label": "<span class='font-text-h4'>Camera</span>",
"connectionColor": "",
"align": "left"
}
},
{
"id": 1038330,
"name": "permissions.screen.1.dropDownList.9",
"nodeType": "dropDownList",
"properties": {
"connection": "false",
"imageUrlOpened": "",
"fixed": "true",
"state": "true",
"imageUrl": "media/81/6d/816dc110a328001eee7616a4b08972c3.png",
"data": "[\"<span class='font-text-small'>Microphone permission is required to enable two-way communication between the Authorized Agent and you to complete the KYC video. Audio must be recorded for regulatory purposes.</span>\"]",
"visibility": "true",
"label": "<span class='font-text-h4'>Microphone</span>",
"connectionColor": "",
"align": "left"
}
},
{
"id": 1038331,
"name": "permissions.screen.1.button.main.10",
"nodeType": "button.main",
"properties": {
"visibility": "true",
"action": "",
"backgroundColor": "#FFFFFF",
"text": "<span class='font-text-btn'><span class='color-text-major-first'>Back</span></span>",
"strokeColor": "#B51ACE",
"align": "center"
}
},
{
"id": 1038332,
"name": "permissions.screen.1.button.main.11",
"nodeType": "button.main",
"properties": {
"visibility": "true",
"action": "",
"backgroundColor": "#B51ACE",
"text": "<span class='font-text-btn'><span class='color-text-light-first'>Continue</span></span>",
"strokeColor": "#B51ACE",
"align": "center"
}
},
{
"id": 1038333,
"name": "widgetModalWindow",
"title": "widget of Modal Window",
"nodeType": "widget",
"properties": {
"url": "https://test.test",
"visibility": "true",
"turnOnAvailability": "",
"statusVkyc": ""
},
"nodeFields": [
{
"id": 1038338,
"name": "widgetModalWindow.image.1",
"nodeType": "image",
"properties": {
"imageUrl": "media/0c/43/0c43723f7ea610c343db74a60fea0402.png",
"visibility": "false"
}
},
{
"id": 1038339,
"name": "widgetModalWindow.block.2",
"nodeType": "block",
"properties": {
"visibility": "true",
"text": "<span class='font-text-h4'>Leaving so soon?</span>",
"align": "left"
}
},
{
"id": 1038340,
"name": "widgetModalWindow.block.3",
"nodeType": "block",
"properties": {
"visibility": "true",
"text": "<span class='font-text-body'><span class='color-text-minor-first'>If you cancel the application process, you'll have to enter and verify your details again next time</span></span>",
"align": "left"
}
},
{
"id": 1038341,
"name": "widgetModalWindow.button.main.4",
"nodeType": "button.main",
"properties": {
"visibility": "true",
"action": "",
"color": "#FFFFFF",
"text": "<span class='font-text-btn'><span class='color-text-major-first'>Exit</span></span>",
"strokeColor": "#FFFFFF"
}
},
{
"id": 1038342,
"name": "widgetModalWindow.button.main.5",
"nodeType": "button.main",
"properties": {
"visibility": "true",
"action": "",
"color": "#B51ACE",
"text": "<span class='font-text-btn'><span class='color-text-light-first'>Continue</span></span>",
"strokeColor": "#B51ACE"
}
}
]
}
]
}
]
},
"extapiTime": 0,
"preparingsTime": 0.65
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
- object
{}
{
"status": 0,
"message": "Forbidden request",
"response": {},
"preparingsTime": 0.071
}