CID Platform Service v2

当前服务已经切换到 v2 契约，不再挂载任何 /api/cid/v1/* 接口。

设计原则：平台能力按路由拆分，Bearer token 只负责标识当前账号，业务能力不再通过统一 channel_type 混合封装。

当前服务地址示例：http://www.cid.16qi.com

调用约定

• POST /api/cid/v2/auth/token 是唯一鉴权入口；首次账号不存在时会先做平台登录校验，再自动录入并返回 Bearer token。
• 如果本地账号已存在，auth/token 只校验本地保存密码是否与请求一致；一致则直接返回当前账号绑定 token，不会自动改密。
• 如果平台密码变更，必须先手动更新本地数据库中的密码，并同步清空该账号 access_token，再重新调用 auth/token。
• 所有业务接口都要求 Authorization: Bearer <access_token>。
• 熊猫与小牛能力按各自路由单独暴露；不支持的能力不会继续保留伪统一入口。

接口清单

方法	路径	说明
GET	/healthz	服务健康检查。
POST	/api/cid/v2/auth/token	按 platform_type + username + password 获取或初始化账号绑定的 Bearer token。
POST	/api/cid/v2/xiongmao/shops/list	查询熊猫账号店铺列表，统一返回 media_account_id、mall_id、mall_name、owner_name、expires_at。
POST	/api/cid/v2/xiongmao/pdd/one-hop/goods/add	熊猫拼多多一跳商品接入。
POST	/api/cid/v2/xiongmao/pdd/two-hop/goods/add	熊猫拼多多二跳商品接入。
POST	/api/cid/v2/xiongmao/taobao/seed/goods/add	熊猫淘宝种草页商品接入。
POST	/api/cid/v2/xiongmao/goods/detail	查询熊猫商品详情。
POST	/api/cid/v2/xiongmao/pdd/two-hop/landing-pages/create	创建熊猫二跳落地页。
POST	/api/cid/v2/xiongmao/pdd/two-hop/landing-pages/url	查询熊猫二跳落地页地址。
POST	/api/cid/v2/xiongmao/images/upload	上传图片到熊猫 OSS。
POST	/api/cid/v2/xiongmao/statistics/consumption-details	查询熊猫消耗详情，入参必须传 start_date、end_date，可选 account_ids、page、page_size；不传 account_ids 则全量，传了则按指定账号过滤。page_size 最大只能传 100。接口只返回当前页，并返回 has_more、next_page、total_count 供调用方继续翻页。
POST	/api/cid/v2/xiongmao/statistics/promotion/summary	查询熊猫推广汇总统计。
POST	/api/cid/v2/xiongmao/statistics/promotion/account-dimensions	查询熊猫账号维度统计。
POST	/api/cid/v2/xiongmao/statistics/promotion/goods-dimensions	查询熊猫商品维度统计。
POST	/api/cid/v2/xiongmao/statistics/goods-report	按抓包接口查询熊猫商品统计，支持 start_date、end_date、page、page_size，返回当前页 raw.rows 及 has_more、next_page、total_count。
POST	/api/cid/v2/xiaoniu/shops/list	查询小牛账号店铺列表，统一返回 media_account_id、mall_id、mall_name、owner_name、expires_at。
POST	/api/cid/v2/xiaoniu/pdd/one-hop/goods/add	小牛拼多多一跳商品接入。
POST	/api/cid/v2/xiaoniu/goods/detail	查询小牛商品详情。
POST	/api/cid/v2/xiaoniu/landing-pages/url	查询小牛商品当前落地页地址。
POST	/api/cid/v2/xiaoniu/statistics/consumption-details	查询小牛消耗详情，入参必须传 start_date、end_date，可选 account_ids、page、page_size；不传 account_ids 则全量，传了则按指定账号过滤。page_size 最大只能传 100。接口只返回当前页，并返回 has_more、next_page、total_count 供调用方继续翻页。
POST	/api/cid/v2/xiaoniu/statistics/promotion/summary	查询小牛推广汇总统计。
POST	/api/cid/v2/xiaoniu/statistics/promotion/account-dimensions	查询小牛账号维度统计。
POST	/api/cid/v2/xiaoniu/statistics/promotion/goods-dimensions	查询小牛商品维度统计。
POST	/api/cid/v2/xiaoniu/statistics/goods-report	按抓包接口查询小牛商品统计，入参必须传 start_date、end_date、platform，支持 page、page_size；返回当前页 raw.list 及 has_more、next_page、total_count。