推荐验证更新

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Advice.md

所属接口集：投资建议

请求 URL

POST /v1/api/advice/verify/update

认证方式

Bearer Token（详见 认证与签名）

接口概述

根据指定日期的 K 线数据对推荐记录进行验证，计算涨跌幅并更新状态。

请求参数

参数名	类型	必填	说明
ids	array[int] 或 string	是	推荐 ID 列表。支持数组、逗号分隔字符串，也可通过 id 字段传入。同时支持 Query 参数 ids / id
date	string	是	验证日期，格式 YYYY-MM-DD

接口说明

• ids 和 date 均为必填。
• ids 支持多种传入方式：请求体 ids 数组、请求体 id 字段、Query 参数 ids、Query 参数 id，支持逗号分隔字符串。
• 验证逻辑：
• 若推荐记录 status=1（已验证），跳过并返回当前 pct_chg。
• 根据推荐记录的股票代码和指定日期查询 K 线数据（tdx_kline_data），取当日最高价。
• 计算公式：pct_chg = (high - recommended_price) / recommended_price * 100，保留四位小数。
• 验证成功后更新 pct_chg、status=1 和 verified_at。
• 返回每条记录的验证结果。

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "date": "2024-07-09",
    "updated": 2,
    "items": [
      {
        "id": 1,
        "pct_chg": 3.21,
        "status": 1
      },
      {
        "id": 2,
        "message": "kline not found for date"
      }
    ]
  }
}

返回状态

状态码	说明
200	成功
400	参数错误（ids 缺失、date 缺失或格式无效）
401	未认证
403	无权限

---