Phạm vi của khóa
Hạn chế theo dự án
Trường Dự án (Project) giới hạn khóa API theo một dự án cụ thể:
- Bất kỳ (Any) — khóa có quyền truy cập mọi dự án trong tài khoản
- Một dự án cụ thể — khóa chỉ làm việc với dữ liệu của dự án được chọn
Hạn chế này hoạt động khác nhau tùy phương thức. Trong các phương thức danh sách, nó là bộ lọc: phản hồi thành công nhưng chỉ chứa dữ liệu của dự án đó. Trong các phương thức trỏ đến một hóa đơn hoặc ví cụ thể, yêu cầu đến đối tượng của dự án khác bị từ chối với Restricted project.
| Phương thức | Khóa bị giới hạn theo dự án |
|---|---|
billing/balances | Dữ liệu cấp tài khoản; hạn chế không áp dụng |
billing/history | Các giao dịch của dự án cộng với giao dịch cấp tài khoản — nạp tiền và thưởng |
billing/tariffs | Mức phí và doanh số chỉ cho dự án của khóa |
invoices/list | Kết quả chỉ cho dự án của khóa |
payments/list | Kết quả chỉ cho dự án của khóa |
statistics/invoices | Chỉ tính cho dự án của khóa |
statistics/payments | Chỉ tính trên các hóa đơn thuộc dự án của khóa |
invoices/create | projectId trong yêu cầu phải trùng với dự án của khóa |
invoices/cancel | Hóa đơn của dự án khác không truy cập được |
invoices/bindPayment | Hóa đơn của dự án khác không truy cập được |
Hạn chế theo phạm vi
Phạm vi xác định khóa được dùng những phương thức API nào. Đây là trường bắt buộc, chọn nhiều giá trị.
Lời gọi đến phương thức ngoài phạm vi của khóa bị từ chối với Restricted scope.
Kết hợp các hạn chế
Hạn chế theo dự án và theo phạm vi hoạt động cùng nhau. Ví dụ, nếu khóa bị giới hạn ở các phương thức hóa đơn và gắn với một dự án cụ thể, thì:
- Chỉ các phương thức hóa đơn khả dụng
- Dữ liệu chỉ được lọc theo dự án đã chỉ định
- Yêu cầu về thanh toán hoặc thống kê bị từ chối
- Yêu cầu dữ liệu của dự án khác bị từ chối