Workflow Tasks Query API là gì?
API này được sử dụng để truy cập các tác vụ workflow của người dùng hiện tại.
Phiên bản API
|
Phiên bản API |
Thời gian cập nhật |
Mô tả |
|
V1 |
18.09.2023 |
Dưới đây là ba tham số phản hồi mới:
Thời gian bắt đầu cho tác vụ: tasks[].create_time
Thời gian kết thúc cho tác vụ: tasks[].finish_time
Trạng thái tác vụ: tasks[].status |
|
V2 |
01.12.2023 |
Thêm hai tham số phản hồi: - Hành động workflow để tạo tác vụ: tasks[].create_action - Hành động workflow để hoàn thành tác vụ: tasks[].finish_action |
Gọi API
API được sử dụng để truy cập các tác vụ hiện tại của người dùng.
URL yêu cầu: https://api.jodoo.com/api/v4/workflow/task/list
Tần suất yêu cầu: 30 lần/giây
Phương thức yêu cầu: POST
Tham số yêu cầu:
|
Tham số |
Bắt buộc |
Kiểu |
Mô tả |
|
username |
Có |
Chuỗi |
Tham chiếu đến Mã số người dùng trong Danh bạ. |
|
Limit |
Không |
Số |
Tham số phân trang. Kích thước trang mặc định là 10 và tối đa là 100. |
|
skip |
Không |
Số |
Tham số phân trang. Số bản ghi bỏ qua mặc định là 0. |
Ví dụ yêu cầu:
Khối đoạn mã chưa được hỗ trợ
Tham số phản hồi:
|
Tham số |
Kiểu |
Mô tả |
|
has_more |
Boolean |
Chỉ ra liệu có dữ liệu tiếp theo hay không |
|
tasks |
Object[] |
Danh sách tác vụ |
|
tasks[].app_id |
Chuỗi |
ID ứng dụng |
|
tasks[].form_id |
Chuỗi |
ID biểu mẫu |
|
tasks[].task_id |
Chuỗi |
ID tác vụ |
|
tasks[].instance_id |
Object[] |
ID bản ghi, tương tự data_id |
|
tasks[].form_title |
Chuỗi |
Tên biểu mẫu |
|
tasks[].title |
Chuỗi |
Tên tác vụ |
|
tasks[].flow_id |
Số |
ID nút |
|
tasks[].flow_name |
Chuỗi |
Tên nút |
|
tasks[].url |
Chuỗi |
Liên kết truy cập tác vụ |
|
tasks[].assignee |
Đối tượng |
Thông tin người được giao tác vụ, theo cấu trúc thực thể thành viên |
|
tasks[].creator |
Đối tượng |
Thông tin người tạo tác vụ, theo cấu trúc thực thể thành viên |
|
tasks[].create_time |
Chuỗi |
Thời gian bắt đầu tác vụ |
|
tasks[].create_action |
Chuỗi |
Các hành động liên quan đến workflow khi tạo tác vụ:
- auto_approve: loại bỏ người duyệt trùng và giữ lại người duyệt cấp cao nhất - forward: gửi duyệt - back: trả lại - transfer: chuyển giao - revoke: thu hồi - activate: kích hoạt - auto_forward: tự động gửi duyệt các tác vụ quá hạn - auto_back: tự động trả lại các tác vụ quá hạn - batch_forward: gửi duyệt hàng loạt - batch_transfer: thay đổi người duyệt hàng loạt - sign_before: thêm người duyệt trước - sign_after: thêm người duyệt sau - sign_parallel: thêm người duyệt song song - invoke_plugin: chạy plugin |
|
tasks[].finish_time |
Chuỗi |
Thời gian kết thúc tác vụ |
|
tasks[].finish_action |
Chuỗi |
Các hành động liên quan đến workflow khi hoàn thành tác vụ:
- auto_approve: loại bỏ người duyệt trùng và giữ lại người duyệt cấp cao nhất - forward: gửi duyệt - back: trả lại - close: đóng - transfer: chuyển giao - batch_forward: gửi duyệt hàng loạt - sign_after: thêm người duyệt sau |
|
tasks[].status |
Số |
Trạng thái tác vụ |
Ví dụ phản hồi:
Khối đoạn mã chưa được hỗ trợ
Tôi đã đọc xong. 🏆
👉Tôi rất háo hức để THIẾT LẬP API.
👉Tôi cần thêm HỖ TRỢ tại Cộng đồng Jodoo.
