来源:谁提供的,授权状态是什么
每个数值都应能回答「从哪来」。本站当前使用公开行情接口,并在页面显著位置披露供应商、接口域名与「尚未取得商业数据授权」这一事实。来源不是装饰性脚注:它决定了数值能否用于对外发布、能否商用、以及在出现争议时向谁追溯。换成正式授权源时,只需替换服务端适配层,前端契约不变。
时点:行情时点不等于获取时间
行情时点是上游数据对应的交易时刻,获取时间是本站服务器拉取该数据的时刻,两者在休市日可能相隔十几个小时。本站把二者分开显示:数值旁标注上游返回的 HKT / ET 行情时点,模块下方标注获取时间(北京时间)。把获取时间当成行情时点,是财经页面最常见的误导之一。
口径:单位、参照值、复权与样本范围
价格指数还是总回报、是否复权、涨跌幅以哪个前收盘为分母、涨跌分布是样本还是全市场,这些都属于口径。本站的涨跌分布明确标注为「本站跟踪标的样本」,并给出样本数量;任何由样本推导的表述都不会被写成全市场结论。口径不清的数值,即使数字正确也不具备可比性。
延迟:实时、收盘还是延迟行情
本站数据为收盘或延迟行情,并非实时报价。交易状态(开市、休市)是按系统时间实时计算的独立信息,与行情数值的新鲜程度无关,两者不可互相印证。页面把这两件事分开说明,避免读者看到「交易中」就以为看到的是实时价格。
缺值时为什么坚持留空
上游解析失败、字段缺失或接口不可用时,正确响应是把该字段置为 null 并显示空状态,同时说明原因。补 0、复用昨收、用示意曲线代替真实走势,都会把「没有数据」伪装成「数据是这样」。本站服务端适配器对任何解析失败一律返回 null,前端只消费契约,不自行推算。
三级降级状态
正常状态为 ok;上游刷新失败时进入 stale,展示最近一次成功快照并明确标旧;完全不可用时进入 unavailable,所有数值显示空状态。三种状态在数据披露栏都有明确文案,读者始终知道屏幕上的数字属于哪一种情况。