Appcircle MCP Server

get_build_profiles - Lấy hồ sơ build cho tổ chức hiện tại (phân trang). Tùy chọn lọc theo tên hồ sơ, nền tảng, trạng thái build gần nhất và nguồn repository. Tùy chọn sắp xếp.

• Mức truy cập: read
• page: Số trang (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang (1-100). Mặc định: 25. Giá trị trên 100 bị giới hạn ở 100. (number, optional)
• search: Từ khóa tìm kiếm tùy chọn để lọc hồ sơ (khớp một phần không phân biệt hoa thường theo tên hồ sơ; API tìm kiếm có thể khớp cả các trường hồ sơ khác). (string, optional)
• platform: Danh sách mã nền tảng tùy chọn để lọc. Giá trị cho phép: 1=iOS, 2=Android. (list of numbers, optional)
• last_build_status: Danh sách mã trạng thái build gần nhất tùy chọn để lọc. Giá trị cho phép: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running. (list of numbers, optional)
• repository_source: Danh sách mã nguồn repository tùy chọn để lọc. Giá trị cho phép: 1=GitHub, 2=Bitbucket, 3=GitLab, 4=Azure DevOps, 6=Public Repository, 7=Private Repository, 8=SSH. (list of numbers, optional)
• sort: Mã trường sắp xếp tùy chọn. Giá trị cho phép: 1=Profile Name, 2=Create Date, 3=Last Build Date. (number, optional)
• sort_direction: Mã hướng sắp xếp tùy chọn. Giá trị cho phép: 1=ASC, 2=DESC. (number, optional)

get_build_profile_details - Lấy một hồ sơ build theo ID, tùy chọn bao gồm cả cấu hình build của hồ sơ đó.

• Mức truy cập: read
• profile_id: ID hồ sơ build (ví dụ: UUID). (string, required)
• configurations: Nếu true, cũng lấy các cấu hình build của hồ sơ. Mặc định: false. (boolean, optional)

get_build_configuration_details - Lấy một cấu hình build theo ID hồ sơ và ID cấu hình.

• Mức truy cập: read
• profile_id: ID hồ sơ build (ví dụ: UUID). (string, required)
• configuration_id: ID cấu hình build (ví dụ: UUID). (string, required)

get_build_profile_workflows - Lấy workflow cho một hồ sơ build theo ID hồ sơ.

• Mức truy cập: read
• profile_id: ID hồ sơ build (ví dụ: UUID). (string, required)

get_workflow_detail - Lấy một workflow theo ID hồ sơ build và ID workflow.

• Mức truy cập: read
• profile_id: ID hồ sơ build (ví dụ: UUID). (string, required)
• workflow_id: ID workflow (ví dụ: UUID). (string, required)

get_commits_by_branch - Lấy commit cho một nhánh build (phân trang).

• Mức truy cập: read
• branch_id: ID nhánh (ví dụ: UUID). (string, required)
• page: Số trang (bắt đầu từ 1). Nếu cung cấp kèm size, bật phân trang. Mặc định: 1. (number, optional)
• size: Kích thước trang. Nếu cung cấp kèm page, bật phân trang. Mặc định: 25, tối đa 100. (number, optional)

get_commit_details - Lấy một commit theo ID commit (UUID) hoặc theo hash commit (git SHA). Cung cấp commit_id hoặc commit_hash, không cung cấp cả hai.

• Mức truy cập: read
• commit_id: ID commit (UUID). (string, optional)
• commit_hash: Hash commit (git SHA). (string, optional)

get_last_commit - Lấy commit gần nhất trên một nhánh build.

• Mức truy cập: read
• branch_id: ID nhánh (ví dụ: UUID). (string, required)

get_build_status - Lấy trạng thái của một build (ví dụ: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown).

• Mức truy cập: read
• commit_id: ID commit (UUID). (string, required)
• build_id: ID build (UUID). (string, required)

get_build_logs - Lấy nhật ký của một build, tùy chọn giới hạn ở một bước. Mặc định hiển thị dạng cắt bớt phần cuối để tránh làm tràn ngữ cảnh của mô hình.

• Mức truy cập: read
• commit_id: ID commit (UUID). (string, required)
• build_id: ID build (UUID). (string, required)
• step: Tên bước chính xác tùy chọn (không phân biệt hoa thường) để giới hạn đầu ra ở khối nhật ký của một bước. (string, optional)
• full_log: Nếu true, trả về toàn bộ nhật ký thay vì phần cuối mặc định. Vẫn giới hạn ở 256 KB. Mặc định: false. (boolean, optional)
• tail_lines: Số dòng giữ lại từ cuối khi không dùng full_log. Mặc định: 200, tối đa 1000. (number, optional)
• grep: Bộ lọc chuỗi con không phân biệt hoa thường áp dụng cho các dòng trước khi cắt bớt. (string, optional)

get_variable_groups - Lấy tất cả nhóm biến môi trường build của tổ chức, bao gồm biến của từng nhóm (key, value, isSecret, isFile). Giá trị bí mật đã được API làm mờ.

• Mức truy cập: read
• Không có tham số.

trigger_build - SIDE EFFECT: bắt đầu một lần chạy build thực mới (xếp hàng một build thực, tiêu tốn phút/tín dụng build) trên một nhánh (commit đồng bộ mới nhất) hoặc cho một commit cụ thể. Được đăng ký theo mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để từ chối.

• Mức truy cập: write
• profile_id: ID hồ sơ build (ví dụ: UUID). Bắt buộc ở chế độ branch (không có commit_id); không dùng ở chế độ commit. (string, optional)
• workflow_id: ID workflow (ví dụ: UUID). Bắt buộc ở chế độ branch. Tùy chọn ở chế độ commit (dùng workflow cuối/dùng mặc định nếu bỏ trống). (string, optional)
• branch_name: Tên nhánh tùy chọn (ví dụ: "main"). Chỉ dùng ở chế độ branch; fallback về nhánh mặc định của hồ sơ nếu bỏ trống. Không được cung cấp cùng với commit_id. (string, optional)
• commit_id: ID riêng của commit (không phải git hash) để kích hoạt build cho một commit cụ thể thay vì commit mới nhất trên nhánh. Không được cung cấp cùng với branch_name. (string, optional)
• configuration_id: ID cấu hình build tùy chọn (ví dụ: UUID) để dùng thay cho cấu hình mặc định. (string, optional)

cancel_build - SIDE EFFECT: hủy một build đang xếp hàng hoặc đang chạy (công việc thực đang tiến hành sẽ bị dừng; không thể tiếp tục). Được đăng ký theo mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để từ chối.

• Mức truy cập: write
• task_id: ID tác vụ của build (trường "taskId" do trigger_build trả về). (string, required)

• Mức truy cập: read
• Không có tham số. Dưới đây là bản dịch tiếng Việt cho phần 2/4 của tài liệu, giữ nguyên toàn bộ placeholder và cấu trúc Markdown.

get_certificates - Lấy tất cả chứng chỉ ký cho tổ chức. Các trường nhạy cảm (p12Password, p12Binary, metaData, thumbprint) được bỏ qua.

• Mức truy cập: read
• Không có tham số.

get_keystores - Lấy tất cả keystores cho tổ chức (ví dụ: keystores ký Android). Các trường nhạy cảm (password, aliasPassword, binary, checkSum, sha256FingerPrint) được bỏ qua.

• Mức truy cập: read
• Không có tham số.

get_provisioning_profiles - Lấy các hồ sơ cung cấp (provisioning profiles) cho tổ chức (ví dụ: iOS/macOS). Các trường nhạy cảm/lớn (binary, metaData, certificateThumbPrints, provisionedDevices, connectApiKeyId) được bỏ qua. Có thể lọc tùy chọn theo ID ứng dụng (bundle).

• Mức truy cập: read
• app_id: ID ứng dụng (bundle) tùy chọn để lọc hồ sơ cung cấp (ví dụ com.example.app). (string, optional)

get_distribution_profiles - Lấy các hồ sơ phân phối thử nghiệm cho tổ chức hiện tại (phân trang). Có thể lọc tùy chọn theo tên hồ sơ, nền tảng và loại xác thực. Có thể sắp xếp tùy chọn.

• Mức truy cập: read
• page: Số trang (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (number, optional)
• search: Từ khóa tìm kiếm tùy chọn để lọc hồ sơ (khớp một phần không phân biệt hoa thường trên tên hồ sơ; tìm kiếm của API cũng có thể khớp các trường khác của hồ sơ). (string, optional)
• platform: Danh sách mã nền tảng tùy chọn để lọc. Giá trị cho phép: 1=iOS, 2=Android. (list of numbers, optional)
• authentication_type: Danh sách mã loại xác thực tùy chọn để lọc. Giá trị cho phép: 1=Không có, 3=Đăng nhập tĩnh, 4=LDAP, 5=SSO. (list of numbers, optional)
• sort: Mã trường sắp xếp tùy chọn. Giá trị cho phép: 1=Tên hồ sơ, 2=Ngày tạo, 3=Ngày tải lên cuối. (number, optional)
• sort_direction: Mã hướng sắp xếp tùy chọn. Giá trị cho phép: 1=TĂNG DẦN, 2=GIẢM DẦN. (number, optional)

get_distribution_profile_details - Lấy một hồ sơ phân phối thử nghiệm cụ thể theo ID (có phân trang phiên bản ứng dụng tùy chọn).

• Mức truy cập: read
• profile_id: ID hồ sơ phân phối (ví dụ UUID). (string, required)
• page: Số trang cho các phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang cho các phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (number, optional)

get_testing_groups - Lấy tất cả nhóm phân phối thử nghiệm cho tổ chức, bao gồm email của từng tester thành viên và loại nhóm.

• Mức truy cập: read
• Không có tham số.

update_app_version_release_notes - TÁC ĐỘNG PHỤ: ghi đè ghi chú phát hành ("message") hiển thị cho tester của một phiên bản ứng dụng phân phối. Trả về đối tượng phiên bản ứng dụng đã cập nhật (loại trừ certThumbPrints). Được đăng ký mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để chọn không tham gia.

• Mức truy cập: write
• profile_id: ID hồ sơ phân phối (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)
• message: Nội dung ghi chú phát hành mới. (string, required)

send_app_version_to_testers - TÁC ĐỘNG PHỤ: gửi thông báo thực sự đến tester/nhóm thử nghiệm, triển khai tác vụ phân phối cho một phiên bản ứng dụng cụ thể. Được đăng ký mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để chọn không tham gia.

• Mức truy cập: write
• profile_id: ID hồ sơ phân phối (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)
• message: Thông báo hiển thị cho tester. (string, required)
• testers: Danh sách tester để gửi. Mỗi mục là một địa chỉ email của tester hoặc ID nhóm thử nghiệm (trường "id" từ get_testing_groups). (list of strings, required)

get_publish_profiles - Lấy các hồ sơ xuất bản cho tổ chức hiện tại theo một loại nền tảng nhất định (phân trang). Có thể lọc tùy chọn theo trạng thái luồng, chợ ứng dụng mục tiêu, sự hiện diện của bản nhị phân ứng viên phát hành và trạng thái cửa hàng. Có thể sắp xếp tùy chọn.

• Mức truy cập: read
• platform_type: Loại nền tảng của hồ sơ xuất bản ("ios" hoặc "android"). (string, required)
• page: Số trang (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (number, optional)
• flow_status: Mã trạng thái luồng tùy chọn để lọc (ví dụ 0=Thành công, 1=Thất bại, 91=Đang chạy). (number, optional)
• market_place_type: Danh sách mã chợ ứng dụng mục tiêu tùy chọn để lọc. Giá trị cho phép phụ thuộc vào platform_type -- ios: 0=Không khả dụng, 1=App Store Connect, 4=Intune; android: 0=Không khả dụng, 2=Google Play, 3=AppGallery, 4=Intune. (list of numbers, optional)
• has_rc_binary: Bộ lọc tùy chọn cho việc hồ sơ có bản nhị phân ứng viên phát hành hay không. (boolean, optional)
• store_status: Danh sách mã trạng thái cửa hàng tùy chọn để lọc. Giá trị cho phép phụ thuộc vào platform_type (nhiều mã hơn cho ios so với android, ví dụ: ios: "IN_REVIEW", "READY_FOR_SALE", "REJECTED"; android: "NOT_AVAILABLE", "DRAFT", "IN_PROGRESS", "HALTED", "COMPLETED"). (list of strings, optional)
• sort: Mã trường sắp xếp tùy chọn. Giá trị cho phép: 1=Tên hồ sơ, 2=Ngày tạo. (number, optional)
• sort_direction: Mã hướng sắp xếp tùy chọn. Giá trị cho phép: 1=TĂNG DẦN, 2=GIẢM DẦN. (number, optional)

get_publish_profile_details - Lấy một hồ sơ xuất bản cụ thể theo loại nền tảng và ID (có phân trang phiên bản ứng dụng tùy chọn).

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• page: Số trang cho các phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang cho các phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (number, optional)

get_app_version_metadata - Lấy siêu dữ liệu danh sách cửa hàng cho một phiên bản ứng dụng (thông tin đánh giá ứng dụng, bản địa hóa, thông tin phát hành, thông tin phiên bản ứng dụng). appReviewInformation.demoPassword bị loại trừ.

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)

get_metadata_locales - Lấy các locale siêu dữ liệu cửa hàng khả dụng cho một phiên bản ứng dụng (tên, mã, được bản địa hóa, isPrimary).

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)

get_intune_metadata - Lấy siêu dữ liệu ứng dụng Microsoft Intune cho một phiên bản ứng dụng (tên hiển thị, nhà xuất bản, bundle ID, phiên bản, trạng thái xuất bản, loại thiết bị áp dụng, danh mục, v.v.).

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)

get_publish_metadata_lock_status - Kiểm tra xem siêu dữ liệu cửa hàng của hồ sơ xuất bản có bị khóa chỉnh sửa hay không.

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)

get_publish_details - Lấy chi tiết luồng xuất bản cho một phiên bản ứng dụng (trạng thái, thời gian, các bước có thứ tự với lịch sử chạy/artifact/ID tài nguyên log).

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• app_version_id: ID phiên bản ứng dụng (ví dụ UUID). (string, required)

get_publish_step_logs - Lấy log cho một luồng xuất bản, có thể giới hạn trong một bước cụ thể. Mặc định hiển thị dạng cắt bớt phần cuối để tránh tràn ngập ngữ cảnh của mô hình.

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• publish_id: ID luồng xuất bản (trường "id" từ get_publish_details). (string, required)
• step_id: ID bước (trường "id" của bước từ danh sách steps của get_publish_details). (string, required)
• step: Tên bước chính xác tùy chọn (không phân biệt hoa thường) để giới hạn đầu ra vào khối log của một bước. (string, optional)
• full_log: Nếu true, trả về toàn bộ log thay vì phần cuối mặc định. Vẫn giới hạn ở 256 KB. Mặc định: false. (boolean, optional)
• tail_lines: Số dòng giữ lại từ cuối khi không dùng full_log. Mặc định: 200, tối đa 1000. (number, optional)
• grep: Bộ lọc chuỗi con không phân biệt hoa thường áp dụng cho các dòng trước khi cắt bớt. (string, optional)

get_publish_flows - Lấy các luồng xuất bản được cấu hình cho một hồ sơ xuất bản (tên, ID, toàn bộ tài liệu luồng YAML).

• Mức truy cập: read
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)

start_publish - TÁC ĐỘNG PHỤ: bắt đầu một luồng xuất bản (hoặc khởi động lại từ một bước cụ thể) -- thực hiện công việc xuất bản thực sự (ví dụ: tải lên App Store/Play Store/Intune). Được đăng ký mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để chọn không tham gia.

• Mức truy cập: write
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• publish_id: ID luồng xuất bản (trường "id" từ get_publish_details). (string, required)
• step_id: ID bước tùy chọn để bắt đầu từ bước đó thay vì đầu luồng. (string, optional)
• organization_pool_id: ID nhóm tổ chức tùy chọn (ví dụ UUID) để chạy. (string, optional)

stop_publish - TÁC ĐỘNG PHỤ: hủy một luồng xuất bản đang chạy (công việc thực tế đang diễn ra bị dừng; không thể tiếp tục). Được đăng ký mặc định; đặt AC_MCP_ENABLE_WRITE_TOOLS=false để chọn không tham gia.

• Mức truy cập: write
• platform_type: Loại nền tảng ("ios" hoặc "android"). (string, required)
• profile_id: ID hồ sơ xuất bản (ví dụ UUID). (string, required)
• publish_id: ID luồng xuất bản (trường "id" từ get_publish_details). (string, required)
• step_id: ID bước tùy chọn. (string, optional)
• organization_pool_id: ID nhóm tổ chức tùy chọn (ví dụ UUID). (string, optional)

• Mức truy cập: read
• page: Số trang (bắt đầu từ 1). Mặc định: 1. (number, optional)
• size: Kích thước trang (1-100). Mặc định: 25, tối đa 100. (number, optional)
• platform_type: Danh sách mã nền tảng tùy chọn để lọc. Giá trị cho phép: 1=iOS, 2=Android. (list of numbers, optional)
• publish_type: Danh sách mã loại xuất bản tùy chọn để lọc. Giá trị cho phép: 1=Xuất bản Beta, 2=Xuất bản Live. (list of numbers, optional)
• visibility: Bộ lọc tùy chọn cho việc hồ sơ được liệt kê công khai (true=Đã liệt kê, false=Không liệt kê). (boolean, optional)
• sort: Mã trường sắp xếp tùy chọn. Giá trị cho phép: 1=Tên ứng dụng, 2=Ngày tạo, 3=Số lượt tải, 4=Ngày nhận binary. (number, optional)
• sort_direction: Mã hướng sắp xếp tùy chọn. Giá trị cho phép: 1=TĂNG DẦN, 2=GIẢM DẦN. (number, optional)

• Mức truy cập: read
• profile_id: ID hồ sơ cửa hàng ứng dụng doanh nghiệp (ví dụ: UUID). (string, bắt buộc)
• page: Số trang cho các phiên bản ứng dụng (bắt đầu từ 1). Mặc định: 1. (number, tùy chọn)
• size: Kích thước trang cho các phiên bản ứng dụng (1-100). Mặc định: 25, tối đa 100. (number, tùy chọn)
• Trường publishType của mỗi phiên bản ứng dụng là một số nguyên: 0=Không có, 1=Beta, 2=Live.

get_build_history_report - Lấy báo cáo lịch sử build, có thể lọc theo khoảng ngày, hồ sơ build và tổ chức. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• build_profile_name: Lọc theo tên hồ sơ build. (string, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)

get_build_queue_waiting_report - Lấy báo cáo thời gian chờ trong hàng đợi build, có thể lọc theo khoảng ngày. Có phân trang. Lưu ý: trên endpoint này, buildDuration nghĩa là thời gian chờ trong hàng đợi tính bằng phút, không phải thời gian thực thi (khác với get_build_history_report).

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). Phải <= end_date nếu cả hai được cung cấp. (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)

get_build_activity_log - Lấy nhật ký hoạt động build (thay đổi workflow/hồ sơ, bản phát hành CodePush, v.v.), có thể lọc theo khoảng ngày và các tham số khác. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). Phải <= end_date nếu cả hai được cung cấp. (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• platform: Lọc theo loại nền tảng (mã số nguyên, ví dụ: 0=Android, 1=iOS). (number, tùy chọn)
• email: Lọc theo email của người dùng thực hiện. (string, tùy chọn)
• profile_name: Lọc theo tên hồ sơ build. (string, tùy chọn)
• action: Lọc theo mã hành động hoạt động (số nguyên; xem BUILD_ACTIVITY_ACTIONS trong mã nguồn công cụ để biết ánh xạ đầy đủ). (number, tùy chọn)

get_build_insights_report - Lấy Báo cáo Thông tin chi tiết về Build đã được tính toán (Ảnh chụp Tình trạng Sức khỏe + Xu hướng, Nguyên nhân gốc, Sức khỏe Artifact, Chất lượng Workflow, Thời gian chờ trong hàng đợi và phân tích Đánh giá Mức độ Trưởng thành) dựa trên lịch sử build, được tổng hợp phía máy chủ. Khác với get_build_history_report, báo cáo này tự động lấy từng trang bên trong và trả về các kết quả được tổng hợp trước nhỏ thay vì các bản ghi thô.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD) cho giai đoạn hiện tại. Mặc định: 30 ngày gần nhất. (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD) cho giai đoạn hiện tại. (string, tùy chọn)
• sections: Danh sách tùy chọn các phần cần tính toán: health_snapshot, root_cause, artifact_health, workflow_quality, queue_time, maturity_assessment. Mặc định: tất cả sáu phần. (array of strings, tùy chọn)
• include_sub_orgs: Nếu true, giữ các bản ghi build đa tổ chức trong các chỉ số dựa trên lịch sử thay vì lọc theo tổ chức của token. Mặc định: false. (boolean, tùy chọn)

get_distribution_app_version_report - Lấy báo cáo sử dụng hàng ngày cho các phiên bản ứng dụng được phân phối. Có phân trang; hỗ trợ lọc theo hồ sơ, hệ điều hành, tổ chức.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• profile_name: Lọc theo tên hồ sơ phân phối. (string, tùy chọn)
• os: Lọc theo hệ điều hành ("ios" hoặc "android"). (string, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)

get_distribution_sent_report - Lấy báo cáo sử dụng hàng ngày cho việc chia sẻ ứng dụng được phân phối. Có phân trang; hỗ trợ lọc theo hồ sơ, hệ điều hành, tổ chức.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• profile_name: Lọc theo tên hồ sơ phân phối. (string, tùy chọn)
• os: Lọc theo hệ điều hành ("ios" hoặc "android"). (string, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)

get_enterprise_app_store_app_usage_report - Lấy báo cáo sử dụng ứng dụng cho cửa hàng ứng dụng doanh nghiệp. start_date và end_date là bắt buộc. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu (YYYY-MM-DD). (string, bắt buộc)
• end_date: Ngày kết thúc (YYYY-MM-DD). (string, bắt buộc)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• organization_id: Bộ lọc tùy chọn theo UUID của tổ chức. (string, tùy chọn)

get_publish_resign_report - Lấy báo cáo ký lại khi phát hành, có thể lọc theo khoảng ngày, tên ứng dụng, tổ chức và trạng thái. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• app_name: Lọc theo tên ứng dụng. (string, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• status: Lọc theo trạng thái ký lại (0=đang chờ, 1=đang xử lý, 2=thành công, 3=thất bại, 4=đã hủy, 5=hết thời gian). (number, tùy chọn)

get_publish_status_report - Lấy báo cáo trạng thái phát hành, có thể lọc theo khoảng ngày, tên ứng dụng, tổ chức và trạng thái. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• app_name: Lọc theo tên ứng dụng. (string, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• status: Lọc theo trạng thái phát hành (ví dụ: 0=Thành công, 1=Thất bại, 91=Đang chạy). (number, tùy chọn)

get_signing_report - Lấy báo cáo ký, có thể lọc theo khoảng ngày, tổ chức, hệ điều hành và trạng thái build. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• os: Lọc theo hệ điều hành ("ios" hoặc "android"). (string, tùy chọn)
• build_status: Lọc theo trạng thái build (ví dụ: 0=Thành công, 1=Thất bại, 91=Đang chạy). (number, tùy chọn)

get_signing_activity_log - Lấy nhật ký hoạt động ký (ví dụ: thông báo hết hạn chứng chỉ/hồ sơ cấp phép/keystore), có thể lọc theo khoảng ngày và các tham số khác. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). Phải <= end_date nếu cả hai được cung cấp. (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• platform: Lọc theo nền tảng (ví dụ: "iOS", "Android"). (string, tùy chọn)
• email: Lọc theo email của người dùng thực hiện. (string, tùy chọn)
• action: Lọc theo mã hành động hoạt động (số nguyên; xem SIGNING_ACTIVITY_ACTIONS trong mã nguồn công cụ để biết ánh xạ đầy đủ). (number, tùy chọn)

get_publish_activity_log - Lấy nhật ký hoạt động phát hành (ký lại, sự kiện luồng phát hành, v.v.), có thể lọc theo khoảng ngày và các tham số khác. Có phân trang.

• Mức truy cập: read
• start_date: Ngày bắt đầu tùy chọn (YYYY-MM-DD). Phải <= end_date nếu cả hai được cung cấp. (string, tùy chọn)
• end_date: Ngày kết thúc tùy chọn (YYYY-MM-DD). (string, tùy chọn)
• page: Số trang (mặc định: 1). (number, tùy chọn)
• size: Số mục trên mỗi trang (1-100, mặc định: 50). (number, tùy chọn)
• organization_id: Lọc theo UUID của tổ chức. (string, tùy chọn)
• platform: Lọc theo nền tảng (ví dụ: "iOS", "Android"). (string, tùy chọn)
• email: Lọc theo email của người dùng thực hiện. (string, tùy chọn)
• profile_name: Lọc theo tên hồ sơ phát hành. (string, tùy chọn)
• action: Lọc theo mã hành động hoạt động (số nguyên; xem PUBLISH_ACTIVITY_ACTIONS trong mã nguồn công cụ để biết ánh xạ đầy đủ). (number, tùy chọn)