这个品类的数据长什么样
焦炭作为大连商品交易所上市的煤炭类期货品种，其行情数据主要来自交易所官方公开接口与合规第三方聚合数据源。交易日内交易时段每3秒更新一次实时成交数据，当日收盘后1小时内更新盘后结算数据，非交易日无实时更新。单条标准行情文档包含合约代码、交割月份、最新成交价格、结算价格、当日涨跌差额、成交量、持仓量等字段，价格类字段单位为元/吨，成交量与持仓量单位为交易手数，无额外附加统计字段。
这些特征在「分享与嵌入」这一环带来什么约束
焦炭行情的高频实时更新特性，要求嵌入组件必须支持可配置的定时刷新逻辑，避免展示过期的静态数据。多交割月份的合约结构，要求分享链接需支持传入指定合约的参数，确保分享内容匹配目标行情。元/吨的单位规则，要求嵌入配置中保留单位字段的展示开关，避免数据标注缺失导致误解。交易所数据源的跨域限制，要求平台需配置对应域名的跨域白名单，否则嵌入后无法正常拉取数据。非交易日无更新的特性，要求嵌入组件需适配空数据状态，避免展示错误提示信息。此外，焦炭作为细分期货品类，其行情播报内容需固定关联合约参数，无法通用化适配其他品类的分享逻辑。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
share_link_allow_params | ["contract_code", "refresh_interval"] | 焦炭行情需指定目标合约与刷新频率，匹配品类数据特征 |
embed_component_refresh_interval | 300 秒 | 焦炭实时行情更新频率较高，5分钟刷新可平衡数据时效性与接口负载 |
external_api_cors_whitelist | ["https://api.dce.com.cn", "https://quote.cjdata.com"] | 焦炭数据源来自大连商品交易所与合规行情聚合接口，需配置对应域名允许跨域嵌入 |
embed_show_unit | 开启 | 焦炭行情单位为元/吨，需保留单位标注确保数据准确 |
embed_empty_state_text | 非交易日无焦炭行情数据 | 非交易日无实时更新，需展示明确的空状态提示 |
share_guest_link_enabled | 开启 | 匹配用户分享免登录行情播报链接的场景需求 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：嵌入的分享组件显示默认提示语无法移除。原因：未配置
embed_custom_prompt参数，使用了平台默认的会话提示文案，未替换为焦炭行情专属提示。 - 现象：免登录分享链接无法查看访客使用记录。原因：未开启
share_log_guest_access配置项，开源版本4.8.14默认关闭该日志记录功能，需手动开启。 - 现象：嵌入组件加载后返回403跨域报错。原因：未将焦炭行情数据源域名加入
external_api_cors_whitelist配置，浏览器跨域限制导致接口请求失败。
怎么确认配好了
- 访问携带指定
contract_code参数的分享链接，确认页面展示对应焦炭合约的行情数据。 - 等待配置的刷新间隔时长，确认嵌入组件自动更新数据，验证刷新逻辑生效。
- 在非交易日访问嵌入组件，确认展示预设的空数据提示文案，不展示错误提示。
- 检查平台的访客访问日志页面，确认通过免登录链接的访问记录被正常留存，验证日志配置生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。