用途:用一次受控的 Clari 预测导出,验证 Revenue API 的完整异步导出契约,适合证明 API 连通性或学习导出任务流程。
主要能力:提交预测导出请求、轮询任务状态、在完成后获取结果,并记录预测 ID、任务 ID、终态、结果格式与脱敏结构样本。
使用方式:先冻结请求参数(预测 ID、时间范围、数据类型、范围 ID、币种、历史选项、JSON 或 CSV 格式);读取 /admin/limits 确认并发容量与月度配额;向 POST /export/forecast/{forecastId} 提交请求并保留返回的任务 ID;用 /export/jobs/{jobId} 有界退避轮询,直到 DONE、ABORTED 或超时;仅在 DONE 后调用 /export/jobs/{jobId}/results 获取一次结果并校验内容类型与结构;最后记录行数、结构指纹、状态时间线与清理结果,并按策略删除临时数据。
认证:Revenue API 令牌仅通过 HTTPS 放在 apikey 请求头中,权限跟随令牌所有者的 Clari 访问与层级。
限制:不得在日志中记录请求头、原始响应体或收入数值;SCHEDULED 或 STARTED 不算完成;未经明确批准不得创建、更新、取消、删除、导出或发布提供方数据。失败时需重新复制预测 ID、在超时后停止并避免重复排队、确认任务已完成且未过期。
其他细节暂未提供。