整頁處理完成才更新續讀位置
Stripe 這份分頁指引所列的列表 API 以物件編號作游標,並用 has_more 表示後面仍有資料;其他 API 系列要先查自己的參數及續讀規格。不要自行拆解續讀值。以下本地例子要整頁每項都有結果,才保存下一個位置。
| 頁 | 結果 | 可保存位置 |
|---|---|---|
| 開始 | 項目 A/B;下一游標 C1 | A/B 處理確認後保存 C1 |
| C1 | 項目 C/D;處理 D 時中斷 | 整頁未完成前保留 C1 |
| 重讀 C1 | C 已處理,D 現在完成 | 更新至回傳的 C2 |
游標要連查詢條件一起保存
續讀位置要附篩選條件、帳戶範圍及規格版本。不能假設不同查詢可共用游標。游標過期遭拒時,按供應商的重開始方法,並核對已保留紀錄是否重複。
一頁只有一半處理成功,可以先保存下一游標嗎?
查看參考答案
只有另有可靠逐筆恢復安排,保留所有未完成編號,才可這樣做。否則保留目前頁的續讀位置,重讀也不能產生重複結果。