沃尔玛 Marketplace 收紧按需报告 API 时间表格式与必填字段

沃尔玛 Marketplace API 更新日志（日期为 2026-10-01）显示，按需报告 API 的时间表端点已于 9 月 25 日变更。

此次变更涉及 GET /v3/reports/schedules、POST /v3/reports/schedules、GET /v3/reports/schedules/{scheduleId} 和 PUT /v3/reports/schedules/{scheduleId} 四个端点。其中，scheduleStartDate 从普通字符串改为日期格式字符串，请求和响应 schema 均受影响；frequency 字段在 POST /v3/reports/schedules 中变为必填项。

同一批更新还为时间表端点补充了操作 ID 和新的响应：GET /v3/reports/schedules 对应 getAllReportSchedules，POST /v3/reports/schedules 对应 createReportSchedule，DELETE /v3/reports/schedules/{scheduleId} 对应 deleteReportSchedule，GET /v3/reports/schedules/{scheduleId} 对应 getSingleReportSchedule，PUT /v3/reports/schedules/{scheduleId} 对应 updateReportSchedule。

此外，POST /v3/reports/schedules 和 DELETE /v3/reports/schedules/{scheduleId} 新增了可选请求头参数 WM_QOS.IDEMPOTENCY_KEY。各端点还补充了非成功响应：GET /v3/reports/schedules 增加 401、403、429、500；POST /v3/reports/schedules 增加 400、401、403、429、500；DELETE /v3/reports/schedules/{scheduleId} 增加 401、403、404、429、500；GET /v3/reports/schedules/{scheduleId} 增加 401、403、404、429、500；PUT /v3/reports/schedules/{scheduleId} 增加 400、401、403、429、500。

此次调整涉及按需报告 API 的 schedule 端点，开发者需按新格式和必填要求更新调用逻辑，否则可能影响报告生成与获取。