Truy xuất Danh sách Phòng ban là gì?
API Truy xuất Danh sách Phòng ban (Đệ quy) cho phép bạn lấy tất cả các phòng ban con của một phòng ban được chỉ định theo ID (đệ quy).
Phiên bản API
|
Phiên bản API |
Thời gian Cập nhật |
Mô tả Phiên bản |
|
V1 |
28/10/2022 |
Tần suất gọi API được tăng từ năm lần/giây lên mười lần/giây. Tham số "dept_no" được chuyển vào thân yêu cầu, và đường dẫn API được đổi thành POST corp/department/user/list. |
|
V2 |
01/08/2023 |
Thêm tham số phản hồi mới có tên "seq" vào cấu trúc thực thể phòng ban. Tham số này cho phép sắp xếp các phòng ban trong cùng một phòng ban cha. |
Gọi API
API cho phép bạn lấy tất cả các phòng ban con của một ID phòng ban được chỉ định (đệ quy).
URL Yêu cầu: https://api.jodoo.com/api/v5/corp/department/list
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ố |
Bắt buộc |
Kiểu |
Mô tả |
|
dept_no |
Có |
Số |
Số hiệu phòng ban |
|
has_child |
Không |
Boolean |
Hệ thống được thiết lập không lấy đệ quy tất cả các phòng ban con. Tức là chỉ có thể lấy các phòng ban cấp ngay dưới. |
Ví dụ Yêu cầu:
Lấy danh sách tất cả các phòng ban đệ quy dưới phòng ban gốc của doanh nghiệp hiện tại. Lưu ý: số 1 là ID của phòng ban gốc.
{ "dept_no": 1, "has_child": true }
Phản hồi:
|
Tham số |
Kiểu |
Mô tả |
|
departments |
Mảng |
Danh sách các phòng ban con dưới phòng ban được chỉ định hiện tại |
Ví dụ Phản hồi:
{ "departments": [ { "dept_no": 3, "name": "Finance department", "parent_no": 1, "type": 0, "status": 1 }, { "dept_no": 33, "name": "Sales Department", "parent_no": 3, "type": 0, "status": 1 "seq": 2 } ] }
