和「查询油价」不同,「查询行情」(138-49)用来查涨跌幅与调价日,prov 为必填。
两个接入点对 prov 的必填规则不一样:查询油价(138-46)prov 选填,查询行情(138-49)prov 必填。
典型链路:用户选省份 → 后端调今日油价(prov=省名)→ 缓存每日结果 → 前端加油页渲染油价卡片。
查询油价返回 showapi_res_body.list[],每一项是一省油价,含 prov 和 8 个标号字段 + 更新时间 ct。
今日油价是免费接口,注册拿到 AppKey 即可调用,按省名查询全国 31 省汽油/柴油价格。
showapi_res_body 内含五个周期对象:day(今日)、tomorrow(明日)、week(本周)、month(本月)、year(本年)。
用 872 的两接入点可组合出三条产品主线:每日运势留存、星座配对互动、会员深度报告。
星座运势 API 提供标准 OpenAPI 3.0 文档,覆盖接口 872 全部接入点。
接入点 1 用四个 0/1 开关控制返回哪些周期:needTomorrow、needWeek、needMonth、needYear(今日 day 默认返回)。
星座运势 API 提供 MCP 服务,覆盖接口 872 全部接入点,可在支持 MCP 的 AI 客户端里直接调用。
日/明日/周/月四个周期的指数均为最高 5 分(summary/love/money/work_star)。
本系列覆盖 ShowAPI 接口 872「星座运势」 的全部两个接入点:星座运势查询(872-1)与星座配对(872-2)。
响应有两层状态码:系统级 showapi_res_code(鉴权/参数/频率,失败非 0)与业务级 ret_code(在 showapi_res_body 内,0 成功)。
星座运势 + 星座配对可组合成「每日签」「配对测试」「会员运势报告」三大留存场景。
虽免费,但平台「为防止滥用设有使用档次限制」,盲目高频调用会触限;且数据每天仅 1/7/17 点更新 3 次,期间内容不变。
不传 star 时,可传 date=MMdd(生日/日期),接口会自动转换成对应星座再返回运势。



