Files

T

guke a563c1ca4b @ (#111 )

docs/api目录文档分类和补全

---------

Co-authored-by: guke <guke@autohome.com.cn>
Reviewed-on: #111

2026-07-03 15:00:37 +08:00

1.4 KiB

Raw Permalink Blame History

POST /api/v1/trace/finalize — 比价 trace 收尾上云

所属:透传端点（前缀 /api/v1，外卖比价） | 鉴权:无（MVP 阶段不鉴权） | ← 返回 API 索引

透传到 pricebot-backend。用户终止 / Phase 1 未识别没走到 done 帧时，pricebot 没上云也没回传 trace_url。客户端收尾时打这个，pricebot 按 trace_id 一致性 hash 落到处理这条 trace 的同一进程（dir_cache 在那才能算对 trace 目录），打包上云返回 {trace_url}。

入参

透传 pricebot，客户端按 pricebot 协议组装。关键字段：

字段	类型	说明
`device_id`	string	设备 ID
`trace_id`	string	比价 trace 标识
(透传)		其余字段由 pricebot 定义，本端点不做校验

Mock 入参:

{
  "device_id": "android_abc123def456",
  "trace_id": "tr_20260703_m3n4o5p6",
  "reason": "user_cancelled"
}

出参

透传 pricebot 原始响应，通常包含 trace_url。

Mock 出参:

{
  "trace_url": "https://trace.shaguabijia.com/tr_20260703_m3n4o5p6",
  "ok": true
}

错误码

502 pricebot 不可达或返回 5xx
400 请求体不是合法 JSON

说明

一致性 hash 按 trace_id 路由到同一 pricebot 实例（确保 dir_cache 命中）
MVP 阶段不鉴权
与 /intent/recognize、/price/step 等同属外卖比价透传族

1.4 KiB Raw Permalink Blame History

POST /api/v1/trace/finalize — 比价 trace 收尾上云

入参

出参

错误码

说明

1.4 KiB

Raw Permalink Blame History