What is the Workflow Instances Query API?
The API is used to query workflow instances.
API Version
API Version | Updated Time | Description |
V1 | 2023.09.18 | 1. Add a request parameter:
2. Add some response parameters:
|
V2 | 2023.12.01 | Add two response parameters:
|
API Calling
The API is used to query workflow instances.
Request URL: https://api.jodoo.com/api/v4/workflow/instance/get
Request Frequency: 30 times/second
Request Method: POST
Request Parameters:
Parameter | Required | Type | Description |
instance_id | Yes | String | Instance ID is the same as data_id. |
tasks_type | No | Number | Type of returned task. 0 refers to "Not return" and 1 "Return all". |
Sample Request:
{ "instance_id": "63ff32d918fbc20007a4a082", "tasks_type":1 }
Response Parameters:
Parameter | Type | Description |
url | String | Instance access link |
instance_id | String | Instance ID |
app_id | String | App ID |
form_id | String | Form ID |
form_title | String | Form Name |
update_time | String | Instance modification time |
create_time | String | Created time |
creator | Object | Creator information is the same as member entity structure. |
status | number | Instance status:
|
tasks | Object[] | Task list |
tasks[].app_id | String | App ID |
tasks[].form_id | String | Form ID |
tasks[].form_title | String | Form name |
tasks[].title | String | Task name |
tasks[].instance_id | String | Instance ID |
tasks[].task_id | String | Task ID |
tasks[].flow_id | number | Node ID |
tasks[].flow_name | String | Node name |
tasks[].url | String | Task access link |
tasks[].assignee | Object[] | Pending task assignee information is the same as member entity structure. |
tasks[].creator | Object | Instance creator information is the same as member entity structure. |
tasks[].create_time | String | Start time for tasks |
tasks[].create_action | String | Workflow-related actions for task creation:
|
tasks[].finish_time | String | End time for tasks |
tasks[].finish_action | String | Workflow-related actions for task completion:
|
tasks[].status | Number | Task status:
|
Sample Response:
{ "app_id": "628d8c0d73544c0006a54bfd", "form_id": "63f31ae8144f4a09ec197163", "form_title": "Vehicle application", "instance_id": "63ff32d918fbc20007a4a082", "url": "https://www.jodoo.com/workflow/process_instance/63ff32d918fbc20007a4a082", "update_time": "2022-10-26T13:18:57.605Z", "create_time": "2022-10-26T13:11:45.087Z", "finish_time": null, "status": 0, "creator": { "username": "Jodoo Official", "name": "Jodoo", "departments": [ 1 ], "type": 0, "status": 1 }, "tasks": [ { "app_id": "628d8c0d73544c0006a54bfd", "form_id": "63f31ae8144f4a09ec197163", "form_title": "Vehicle application", "title": "Approval", "instance_id": "63ff32d918fbc20007a4a082", "task_id": "63f31ae8144f4a09ec197162", "flow_id": 0, "flow_name": "Aprroval", "url": "https://www.jiandaoyun.com/workflow/process_instance/63ff32d918fbc20007a4a082/task/63f31ae8144f4a09ec197162", "assignee": { "username": "Jodoo Official", "name": "Jodoo", "departments": [ 1 ], "type": 0, "status": 1 }, "creator": { "username": "Jodoo Official", "name": "Jodoo", "departments": [ 1 ], "type": 0, "status": 1 }, "create_time": "2022-10-26T13:11:45.087Z", "create_action": "forward", "finish_time": 2022-10-26T13:11:45.087Z, "finish_action": "forward", "status": 1 }, { "app_id": "628d8c0d73544c0006a54bfd", "form_id": "63f31ae8144f4a09ec197163", "form_title": "Vehicle application", "title": "Review", "instance_id": "63ff32d918fbc20007a4a082", "task_id": "63f31ae8144f4a09ec197163", "flow_id": 2, "flow_name": "Review", "url": "https://www.jiandaoyun.com/workflow/process_instance/63ff32d918fbc20007a4a082/task/63f31ae8144f4a09ec197163", "assignee": { "username": "Jodoo Official", "name": "Jodoo", "departments": [ 1 ], "type": 0, "status": 1 }, "creator": { "username": "Jodoo Official", "name": "Jodoo", "departments": [ 1 ], "type": 0, "status": 1 }, "create_time": "2022-10-26T13:18:57.605Z", "create_action": "forward", "finish_time": null, "finish_action": null, "status": 0 } ] }
I have finished reading. 🏆
👉I can't wait to SET THE API.
👉I need more HELP in Discord Forum.