參考資料
規格限制
系統與服務的硬性數值限制
內容
| 項目 | 限制 | 超過時的回應 |
|---|---|---|
| 作答內容長度 | 5,000 字元 | 400 ERR_CONTENT_TOO_LONG |
| 作答文件大小 | 256 KB 序列化後 | 400 ERR_CONTENT_TOO_LONG |
| 一題的填充格數 | 20 格 | 400 ERR_VALIDATION_FAILED |
| 題組巢狀層數 | 3 層 | 400 ERR_VALIDATION_FAILED |
字元數的計算方式為所有 text 節點的文字加上所有數學節點的原始碼。詳見作答與題幹的內容格式。多格填充的作答採逐格檢查並同時檢查加總。
請求
| 項目 | 限制 | 超過時的回應 |
|---|---|---|
| 請求本體大小 | 10 MB（解壓縮後） | 413 ERR_PAYLOAD_TOO_LARGE |
| 批次提交筆數 | 100 筆／請求 | 400 ERR_BATCH_TOO_LARGE |
列表分頁 limit | 預設 20，最大 100 | 超過部分會被截至 100 |
| 學生名冊筆數 | 10,000 筆／份名冊 | 400 ERR_VALIDATION_FAILED |
請求本體可以 Content-Encoding: gzip 送出，上限計算的是解壓縮後的大小。作答文件是重複性很高的 JSON，壓縮通常有數倍效果，在批次場景相當有感。帶有內容的請求必須是 Content-Type: application/json，否則回應 415 ERR_UNSUPPORTED_MEDIA_TYPE。
時間
| 項目 | 值 |
|---|---|
| 冪等鍵保留 | 24 小時 |
| Studio 加強驗證（step-up）有效期 | 15 分鐘 |
| Webhook 簽章時間戳容差 | 5 分鐘（±300 秒） |
| Webhook 連線逾時 | 5 秒 |
| Webhook 讀取逾時 | 30 秒 |
| Webhook 重試窗口 | 約 10.6 小時（初次加 5 次重試） |
| Webhook 死信佇列保留 | 30 天 |
Webhook 重試排程
| 遞送 | 距前一次失敗的延遲 |
|---|---|
| 初次 | —（發出時立即） |
| 重試 1 | 1 分鐘 |
| 重試 2 | 5 分鐘 |
| 重試 3 | 30 分鐘 |
| 重試 4 | 2 小時 |
| 重試 5 | 8 小時 |
Webhook 斷路器於連續 10 次失敗時開啟，冷卻 1 小時。冷卻後將送出 3 次試探請求，全部成功後恢復。
其他上限
| 項目 | 限制 |
|---|---|
| 每個 Webhook 端點的有效簽章密鑰 | 2 把（最少亦須保有 1 把） |
| 評分標準級距數值精度 | 最多 2 位小數 |