Lỗi và giới hạn
Mã lỗi, giới hạn số lần gọi và những gì chưa hỗ trợ.
Lỗi
Lỗi trả về theo khuôn trạng thái của OneRoster:
{
"imsx_codeMajor": "failure",
"imsx_severity": "error",
"imsx_description": "\"nope\" cannot be filtered on.",
"imsx_CodeMinor": { "imsx_codeMinorField": [{ "imsx_codeMinorFieldName": "TargetEndSystem", "imsx_codeMinorFieldValue": "invalid_filter_field" }] }
}| Mã HTTP | imsx_codeMinorFieldValue | Khi nào |
|---|---|---|
| 400 | invalid_filter_field, invalid_sort_field, invalid_selection_field, invalid_data | Tham số không hợp lệ |
| 401 | unauthorisedrequest | Thiếu mã, mã sai hoặc hết hạn, kết nối đã thu hồi, mã của trường khác |
| 403 | forbidden | Mã không có quyền cho điểm truy cập này |
| 404 | unknownobject | Không có điểm truy cập hoặc bản ghi này |
| 429 | server_busy | Gọi quá 600 lần trong một phút; đợi rồi thử lại |
| 500 | internal_server_error | Lỗi phía hệ thống; thử lại sau, vẫn lỗi thì báo nhà trường |
| 503 | (không có) | Hệ thống tạm thời không phản hồi; thử lại sau ít phút |
Lỗi khi lấy mã theo OAuth 2.0, xem Xác thực.
Giới hạn
- 600 yêu cầu mỗi phút cho mỗi kết nối.
- Lấy mã: 60 lần mỗi 15 phút cho mỗi địa chỉ mạng.
- Mỗi trường có tối đa 10 kết nối đang hoạt động.
Chưa hỗ trợ
- Ghi qua REST OneRoster: theo chuẩn, phần Danh sách không có lệnh ghi; phần Kết quả cũng không nhận ghi vì kết quả thực tập do chính nền tảng tạo ra. Để gửi dữ liệu vào cổng, dùng gói CSV OneRoster hoặc API của cổng.
- Dịch vụ Resources và người giám hộ. Giáo viên, kỳ chấm điểm, dữ liệu nhân khẩu có điểm truy cập nhưng luôn rỗng.
- Thông báo sự kiện (webhook).