接口成功不代表资料齐全
API 返回成功只说明一次请求被处理,结果可能受到页数、时间范围、保留期和权限限制。导出交易记录前,应明确接口返回的是订单、成交还是账本变化,并核对账户、子账户与产品范围。不能把默认第一页当成全部历史,也不能把空数组直接理解为账户从未发生过活动。
分页方式必须按文档实现
不同接口使用时间、事件标识或前后游标翻页,排序与边界是否包含也可能不同。保存每次请求参数、响应范围和下一游标,不自行假定时间加一秒就不会遗漏。多条记录可能在同一毫秒发生,稳定标识通常比单一时间戳更适合关联,但仍要确认其作用范围。
用重叠窗口发现问题
相邻窗口可有少量重叠,之后按明确的事件键去重。这样有助于检查边界,不能通过简单去重掩盖字段变化。假设一个时间点发生多笔成交,窗口切分若只保留第一条就会漏数。记录最早最晚时间、返回条数和游标变化,出现反复相同一页时应停止并排查。
限流与重试需要可恢复
按官方速率限制分批请求,遇到限流和临时失败时退避重试,并从已确认游标继续。不要为提高速度增加无必要的 API 权限,更不要把读数据密钥升级为可提领。密钥和签名不应进入日志;记录请求摘要即可满足复核,日志文件也应保护账户关联信息。
完整性要靠交叉核对
将导出的成交数量、费用及资产变化与账户报表、月结单或期初期末余额对照。转入、转出、奖励和调整项可能来自其他接口,不能用成交记录解释全部余额。尚无法解释的差异单独标记,不用虚构一笔补差交易。若历史已超接口保留期,应寻找官方报表或工单。
输出可审核的数据包
保存接口文档版本、导出时间、账户范围、分页参数、行数、去重规则和异常清单,同时保留原始响应的安全副本。第三方工具的完整性声明也应能被这些记录验证。本文用于数据整理,不保证特定接口永久可用,也不自动形成税务结论或平台偿付能力判断。
