marco
43f28d358b
- 新增 device-liveness(无障碍存活监控)、internal(内部回写端点)、cps-redirect(CPS 短链落地)三族单文件文档 - API 总览补录此前缺失端点:coupon prompt 频控、report/invite、wxpay 回调、platform 客户端配置、feedback/user/ad 零散读端点 - database 新增 cps_wx_user / device_liveness / launch_confirm_sample 三表文档,更新 OVERVIEW/README/comparison_record/数据库迁移/后端技术实现 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.7 KiB
2.7 KiB
内部回写端点(internal 族,pricebot / 发布流程 → app-server)
所属:internal 组(前缀
/internal,源app/api/internal/) | 鉴权:X-Internal-Secret头(==settings.INTERNAL_API_SECRET) | ← 返回 API 索引
不是给客户端的接口:不走用户 JWT。§6 是 app-server 透传给 pricebot,这里反过来——pricebot(及发布流程)把少量数据 server→server 回写 app-server 落库。
鉴权(所有 internal 端点共用)
请求头带 X-Internal-Secret: <密钥>,服务端常量时间比对 settings.INTERNAL_API_SECRET:
- 密钥未配置(默认空)→
503(挡裸奔写端点)。 - 不匹配 / 缺失 →
401。 - 需 pricebot 与 app-server 两边
.env配同一INTERNAL_API_SECRET才生效(未配则 pricebot 侧跳过上报、不影响比价/领券)。
端点
| 方法 + 路径 | 落库 | 说明 |
|---|---|---|
POST /internal/price-observation |
price_observation |
比价 done 帧整批价格事实上报;(trace_id, platform, scope) 幂等,返回 {inserted, skipped} |
GET /internal/store-mapping/lookup |
(只读 store_mapping) |
比价前按 source_platform+name(+lat/lng)反查各目标平台已沉淀的店铺 id/deeplink;命中→pricebot 直接 deeplink 省现场搜店 |
POST /internal/store-mapping |
store_mapping |
跨平台「同一家店」身份映射上报;trace_id 幂等、填空合并,返回 {inserted, row_id} |
POST /internal/store-mapping/invalidate |
store_mapping |
标记某平台 shop_id 的缓存 deeplink 失效(pricebot 撞错误页回退时报);当前支持 taobao/jd,其它平台 no-op,返回 {ok, affected} |
POST /internal/launch-confirm-sample |
launch_confirm_sample |
启动确认窗 LLM 兜底放行后回写样本(host 包 + 弹窗树 + plan + locale);都上报、不去重,返回 {id} |
POST /internal/app-version |
app_config(key=latest_app_version) |
发布流程(非 pricebot)出 APK 后写最新版本号/下载链接/sha256;客户端再 GET /api/v1/platform/app-version 读做 OTA。也是应急改版本信息(紧急下线/改 apk_url)入口 |
错误
401密钥不匹配 / 缺失。503INTERNAL_API_SECRET未配置。422请求体字段校验失败。
说明
- 与不鉴权的比价透传(
compare.py/coupon.py)无关:那两个是客户端→server 的透传壳,这里是 server→server 的内部写库。 launch-confirm-sample的样本供研发人工定期沉淀进 pricebot 的launch_confirm.PROFILES静态规则(让以后同款启动窗回到快路径,不必再调 LLM)。