接口成功不代表資料齊全
API 返回成功只說明一次請求被處理,結果可能受到頁數、時間範圍、保留期和權限限制。導出交易記錄前,應明確接口返回的是訂單、成交還是賬本變化,並核對賬戶、子賬戶與產品範圍。不能把默認第一頁當成全部歷史,也不能把空數組直接理解為賬戶從未發生過活動。
分頁方式必須按文檔實現
不同接口使用時間、事件標識或前後游標翻頁,排序與邊界是否包含也可能不同。保存每次請求參數、響應範圍和下一游標,不自行假定時間加一秒就不會遺漏。多條記錄可能在同一毫秒發生,穩定標識通常比單一時間戳更適合關聯,但仍要確認其作用範圍。
用重疊窗口發現問題
相鄰窗口可有少量重疊,之後按明確的事件鍵去重。這樣有助於檢查邊界,不能通過簡單去重掩蓋字段變化。假設一個時間點發生多筆成交,窗口切分若只保留第一條就會漏數。記錄最早最晚時間、返回條數和游標變化,出現反復相同一頁時應停止並排查。
限流與重試需要可恢復
按官方速率限制分批請求,遇到限流和臨時失敗時退避重試,並從已確認游標繼續。不要為提高速度增加無必要的 API 權限,更不要把讀數據密鑰升級為可提領。密鑰和簽名不應進入日誌;記錄請求摘要即可滿足復核,日誌文件也應保護賬戶關聯信息。
完整性要靠交叉核對
將導出的成交數量、費用及資產變化與賬戶報表、月結單或期初期末餘額對照。轉入、轉出、獎勵和調整項可能來自其他接口,不能用成交記錄解釋全部餘額。尚無法解釋的差異單獨標記,不用虛構一筆補差交易。若歷史已超接口保留期,應尋找官方報表或工單。
輸出可審核的數據包
保存接口文檔版本、導出時間、賬戶範圍、分頁參數、行數、去重規則和異常清單,同時保留原始響應的安全副本。第三方工具的完整性聲明也應能被這些記錄驗證。本文用於數據整理,不保證特定接口永久可用,也不自動形成稅務結論或平台償付能力判斷。
