Cả 15 phạm vi cho khóa API và kết nối AI: mỗi phạm vi cho phép gì, tên của nó trong bảng điều khiển và những gì không khóa API nào làm được.
Phạm vi xác định một khóa API được làm gì. Cùng 15 phạm vi này cũng áp dụng cho các trợ lý AI bạn kết nối qua MCP. Hãy luôn chỉ chọn những phạm vi mà ứng dụng thực sự cần.
Quy tắc cơ bản
- Mỗi endpoint yêu cầu đúng một phạm vi
- Với khóa API, write:X tự động bao gồm read:X – bảng điều khiển ghi chú “write:X tự động bao gồm read:X”
- Nếu thiếu phạm vi, API phản hồi 403 insufficient_scope và nêu phạm vi cần thiết trong details.required_scope
- Các endpoint hoàn toàn không mở cho khóa API cũng phản hồi 403 insufficient_scope
- Các chức năng của chủ sở hữu và quản trị viên như thành viên, thanh toán hay quản lý tên miền không truy cập được bằng bất kỳ phạm vi nào
Mọi phạm vi
Trong hộp thoại “Tạo khóa API mới”, bạn chọn “Đọc” hoặc “Ghi” cho từng khu vực; danh sách khóa hiển thị tên phạm vi ở cột đầu tiên. Dạng “Đọc · Trang” xuất hiện trên trang chấp thuận của ứng dụng AI và trong “Ứng dụng đã kết nối”.
| Phạm vi | Với ứng dụng AI | Cho phép |
|---|---|---|
| read:pages | Đọc · Trang | Liệt kê và đọc trang, đọc và kiểm tra bản nháp, liệt kê khối, đọc SEO, liệt kê phiên bản, lấy loại khối |
| write:pages | Ghi · Trang | Tạo và chỉnh sửa trang (kể cả handle), chỉnh sửa bản nháp, tạo, chỉnh sửa, xóa và sắp xếp khối, chỉnh sửa SEO, chế độ hiển thị, xuất bản, khôi phục phiên bản, liên kết mời cho trang riêng tư |
| read:links | Đọc · Liên kết | Liệt kê và đọc liên kết của một trang |
| write:links | Ghi · Liên kết | Tạo, chỉnh sửa, xóa và sắp xếp liên kết |
| read:assets | Đọc · Tệp | Liệt kê tệp |
| write:assets | Ghi · Tệp | Tải lên và xóa tệp, tải lên cho một trang |
| read:forms | Đọc · Biểu mẫu | Đọc biểu mẫu, tóm tắt, liệt kê bài gửi và xuất dạng CSV (xuất từ Creator Pro) |
| write:forms | Ghi · Biểu mẫu | Tạo, chỉnh sửa và xóa biểu mẫu |
| read:stats | Đọc · Thống kê | Thống kê trang và không gian làm việc (tóm tắt, chuỗi thời gian, so sánh, liên kết, widget, chuyển đổi, trang hàng đầu), lịch sử thông báo đẩy và mức dùng thông báo đẩy |
| read:workspaces | Đọc · Không gian làm việc | Đọc tính năng của gói, mức sử dụng, danh sách thành viên và cài đặt không gian làm việc, liệt kê tên miền, liệt kê và đọc mẫu, liệt kê và đọc mã bí mật callback (không có mã bí mật dạng văn bản thuần) |
| write:workspaces | Ghi · Không gian làm việc | Hiện không có endpoint nào ngoài read:workspaces |
| read:donations | Đọc · Thanh toán từ người ủng hộ | Tổng các khoản thanh toán từ người ủng hộ của không gian làm việc (thanh toán qua khối “Ủng hộ”) |
| read:short_links | Đọc · Liên kết rút gọn | Liệt kê và đọc liên kết rút gọn |
| write:short_links | Ghi · Liên kết rút gọn | Tạo, chỉnh sửa và xóa liên kết rút gọn |
| write:templates | Ghi · Mẫu không gian làm việc | Tạo, chỉnh sửa và xóa mẫu không gian làm việc của riêng bạn (đọc chúng bằng read:workspaces), xem Mẫu riêng |
Chính xác endpoint nào thuộc phạm vi nào được trình bày trong Các endpoint theo khu vực.
Những gì không khóa API nào làm được
- Xóa trang
- Tạo liên kết xem trước cho bản nháp
- Phân tích thống kê theo thiết bị, quốc gia, nguồn giới thiệu và UTM
- Gửi thông báo đẩy và quản lý quy tắc thông báo đẩy
- Kết nối hoặc ngắt kết nối tích hợp
- Quản lý webhook
- Thêm, xác minh, kích hoạt, vô hiệu hóa hoặc xóa tên miền
- Quản lý thành viên, lời mời và vai trò, chuyển quyền sở hữu
- Đổi cài đặt không gian làm việc, thanh toán
- Tạo, chỉnh sửa, xoay vòng hoặc xóa mã bí mật callback
- Danh sách thanh toán từ người ủng hộ, yêu cầu truy cập dữ liệu và ẩn danh hóa bài gửi biểu mẫu
- Quản lý hồ sơ, các trang bạn theo dõi và chính các khóa API
Những việc này bạn làm trong bảng điều khiển.
Phạm vi cho trợ lý AI
Với kết nối MCP, bạn chọn cùng các phạm vi trên trang chấp thuận. Có hai điểm khác: thứ nhất, quyền ghi ở đó không bao gồm quyền đọc – vì vậy hãy cấp cả hai. Thứ hai, vai trò của bạn giới hạn lựa chọn: người xem chỉ nhận quyền đọc (không gồm biểu mẫu và liên kết rút gọn), biên tập viên nhận mọi quyền trừ “Ghi · Không gian làm việc”, liên kết rút gọn và mẫu không gian làm việc. Xem thêm trong Quyền, bảo mật và giới hạn.
Các tổ hợp khuyến nghị
| Trường hợp sử dụng | Phạm vi |
|---|---|
| Báo cáo và dashboard | read:stats, read:pages |
| Đồng bộ liên kết từ CMS hoặc cửa hàng | write:links, read:pages |
| Tự động quản lý và xuất bản trang | write:pages, write:links |
| Liên kết chiến dịch từ CRM | write:short_links |
| Chuyển khách hàng tiềm năng từ biểu mẫu sang CRM | read:forms |
| Triển khai mẫu từ pipeline CI | write:templates, read:workspaces |
Có thể bạn cũng thấy hữu ích
Không tìm thấy?
Hãy cho chúng tôi biết bạn cần gì, đội hỗ trợ sẽ trực tiếp giúp bạn.