API Tạo Nhiều Bản Ghi là gì?
Bạn có thể thêm nhiều bản ghi vào một biểu mẫu nhất định thông qua API Tạo Nhiều Bản Ghi.
Việc tạo mới và cập nhật bản ghi bị cấm đối với các trường hệ thống và các trường sau đây.
-
Phân cách (Divider)
-
Chữ ký số (Signature)
-
Dữ liệu liên quan (RelatedData) và Truy vấn liên quan (RelatedQuery)
-
Số thứ tự (Serial No.) (Tự động tạo)
Mô tả Phiên bản
|
Phiên bản API |
Thời gian cập nhật |
Mô tả Phiên bản |
|
V 1 |
28/10/2022 |
Tần suất gọi API được tăng từ 5 lần/giây lên 10 lần/giây. Các tham số "app_id" và "entry_id" được đặt trong phần thân yêu cầu và đường dẫn API thay đổi thành "POST app/entry/data/batch_create". |
|
31/08/2023 |
Một tham số yêu cầu mới "data_creator" được thêm vào. |
|
Gọi API
Thêm nhiều bản ghi vào một biểu mẫu nhất định. Tối đa 100 bản ghi được tạo trong một lần gọi.
URL Yêu cầu: https://api.jodoo.com/api/v5/app/entry/data/batch_create
Tần suất Gọi: 10 lần/giây
Phương thức Yêu cầu: POST
Tham số Yêu cầu:
|
Tham số |
Kiểu |
Bắt buộc |
Mô tả |
Mặc định |
|
app_id |
Chuỗi (String) |
Có |
ID ứng dụng |
/ |
|
entry_id |
Chuỗi (String) |
Có |
ID biểu mẫu |
/ |
|
data_list |
Mảng (Array) |
Có |
Các bản ghi cần thêm. |
/ |
|
data_creator |
Chuỗi (String) |
Không |
Người gửi dữ liệu. Giá trị "data_creator" là số hiệu của thành viên. Bạn có thể lấy số hiệu thành viên qua API quản lý danh bạ. |
Chủ doanh nghiệp |
|
transaction_id |
Chuỗi (String) |
Không |
ID giao dịch; transaction_id dùng để định danh duy nhất một giao dịch và ngăn chặn việc tạo ra các giao dịch trùng lặp. Nó cũng dùng để liên kết một nhóm tập tin. Thường dùng UUID để tạo ID giao dịch. |
/ |
|
is_start_workflow |
Boolean |
Không |
Chỉ định có khởi tạo quy trình làm việc hay không (chỉ áp dụng với biểu mẫu quy trình). |
false |
Ví dụ Yêu cầu:
Unknown block type: code
Phản hồi:
|
Tham số |
Kiểu |
Mô tả |
|
status |
Chuỗi (String) |
Kết quả trả về của yêu cầu |
|
success_count |
Số (Number) |
Số bản ghi được thêm thành công |
|
success_ids |
Mảng (Array) |
Danh sách ID của các bản ghi được thêm thành công |
Ví dụ phản hồi:
Unknown block type: code
Cần biết thêm
1. Nếu bạn gặp lỗi khi tạo nhiều bản ghi, thực hiện như sau:
Dùng cùng một transaction_id để tạo lại tất cả các bản ghi. Những bản ghi thất bại trong lần đầu sẽ được thêm vào, các bản ghi thành công sẽ không bị trùng lặp.
2. Nếu bạn thêm tham số "data_creator" và chỉ định người tạo dữ liệu, thì những thành viên thực hiện Tự động hóa (Automations) được kích hoạt và những thành viên khởi tạo quy trình làm việc sẽ là người tạo dữ liệu.
