API Danh sách kiểm tra

Last updated: June 19, 2026

API /checklists/ được tạo ra để cho phép người dùng tải xuống và phân tích các câu trả lời cho Câu hỏi trong checklist trong DISPATCH của L2L. Mỗi bản ghi được trả về trong API này đại diện cho một checklist đã được tạo từ một Điều phối, Cổng thông tin Người vận hành hoặc theo cách thủ công.

Lọc Checklist

API /checklists/ có thể được lọc và sắp xếp theo bất kỳ thuộc tính chính nào, chẳng hạn như: site, tên tài liệu, điều phối, sản phẩm, dây chuyền, máy móc, v.v.

Câu hỏi và Câu trả lời

Câu hỏi và Câu trả lời được tìm thấy lần lượt trong các thuộc tính tasks và answers.  

Danh sách tasks chứa tất cả Câu hỏi có trong phiên bản checklist đã xuất bản tại thời điểm checklist được tạo. Nếu một phiên bản mới của checklist được xuất bản và người dùng chọn cập nhật các Câu hỏi của checklist, danh sách tasks cũng sẽ được cập nhật trong API.

Danh sách answers chứa tất cả các câu trả lời được nhập trên checklist. Mỗi câu trả lời có thuộc tính task_number, là chỉ mục của Câu hỏi trong danh sách tasks mà câu trả lời đó tương ứng. Ví dụ, nếu một câu trả lời có task_number là 3, Câu hỏi liên quan là mục thứ ba trong danh sách tasks.

API answers cũng có các tiêu chí đạt, không đạt, cảnh báo nếu bạn đang sử dụng tính điểm checklist. API sẽ cung cấp cho bạn một số: 0 = Đạt, 1 = Cảnh báo, 2 = Không đạt

 

Bảng

Câu hỏi và Câu trả lời cho các checklist nằm trong bảng cũng được bao gồm trong API /checklists/. Đối tượng task xác định bảng, bao gồm tiêu đề cột, thông tin hàng và cột, cũng như các định nghĩa Câu hỏi. Câu trả lời được bao gồm trong danh sách answers, và Câu hỏi tương ứng có thể được tìm thấy trong danh sách tasks bằng cách sử dụng các thuộc tính task_number, table_row_number và table_column_number.

Các cân nhắc về phát triển

  • Thuộc tính task_hash trên đối tượng task và đối tượng answer tồn tại vì lý do kế thừa. Không nên sử dụng thuộc tính này để liên kết các Câu hỏi và câu trả lời của task với nhau.
  • API /checklistsanswers/ được phát triển và phát hành trước khi các câu trả lời được đưa vào payload của API /checklists/ và sẽ tiếp tục cung cấp các câu trả lời trong tương lai. Tuy nhiên, đối tượng answers trong payload /checklists/ mạnh mẽ hơn và là phương thức được ưu tiên để thu thập câu trả lời checklist.