Payin - Recon File

接口：POST /api/v1/payin/reconFile

请求头：

• token: <string>（API token）
• Content-Type: application/json

请求体：

{
  "date": "2026-03-04"
}

cURL 示例：

curl --location '{ROOT_URL}/api/v1/payin/reconFile' \
  --header 'token: 0a1225c5-0930-4c55-b318-f530eb3333b9' \
  --header 'Content-Type: application/json' \
  --data '{"date": "2026-03-04"}'

响应示例（任务已入队）：

{
  "logId": "2wasdMZttp0UM00NAps0",
  "status": true,
  "message": "Export job queued",
  "data": {
    "jobId": "6527b5959ee883846f7c",
    "note": "Request accepted; re-submit same request to check status; will return download URL when ready"
  }
}

响应示例（导出已完成）：

{
  "logId": "20ExtHQSUb4qT3CheVLD",
  "status": true,
  "message": "Export ready",
  "data": {
    "jobId": "6527b5959ee883846f7c",
    "download": "https://.../recon_2026-03-04_6527b5959ee883846f7c.csv?X-Amz-..."
  }
}

说明：

• date：要导出的对账日期（格式 YYYY-MM-DD）。
• 首次请求时，API 会创建导出任务并返回 jobId。
• 若任务尚未完成，可重复发送相同请求查询状态。
• 完成后，响应会包含 download 字段（临时 CSV 下载地址）。

主要响应字段：

• logId：请求日志 ID。
• status：布尔值，true 表示成功。
• message：简短状态说明。
• data.jobId：导出任务 ID。
• data.download：（准备完成时）用于下载 CSV 的预签名 URL。

安全说明：

• 下载链接通常是临时预签名 URL，具有有效期。
• 请妥善保管 API token，不要提交到仓库中。