这个品类的数据长什么样
航运港口收益率相关数据主要来源于国内各航运交易所公开行情接口、港口运营方的官方上报系统。数据更新节奏分为两类：港口靠泊、吞吐量类数据每小时同步更新，航线运价、收益率类数据每日凌晨完成当日结算后更新。数据文档为结构化JSON格式，包含港口唯一标识、中文名称、所属干线航线、当日作业艘次、集装箱吞吐量单位、基准收益率范围、数据更新时间戳等字段，字段单位包含TEU、艘次、小时等。
这些特征在「分享与嵌入」这一环带来什么约束
由于数据更新节奏存在小时级与日级差异，分享与嵌入环节需适配不同的缓存策略，避免展示过期数据。结构化字段包含专属单位与唯一标识，嵌入时需保留单位信息，否则数据可读性下降。港口数据维度较多，全量接口返回体量较大，分享链接需携带港口代码参数以定向返回目标数据，减少传输开销。同时，航运港口场景下的嵌入应用常部署于企业内部系统或垂直航运平台，需配置跨域访问白名单，防止嵌入后出现加载失败。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
shareExpireTime | 3600 秒 或 86400 秒 | 匹配港口数据小时级、日级的更新节奏，避免分享链接返回过期数据 |
iframeAllowList | ["https://shipping-platform.com", "https://internal-port-system.com"] | 适配航运垂直平台与企业内部系统的嵌入场景，限制跨域访问范围 |
workflowShareUrlEnable | true | 启用后可通过工作流节点生成分享应用的URL地址，满足代码获取分享链接的需求 |
shareAuthType | tokenBased 或 public | 若需用户授权访问则使用tokenBased，公开场景则使用public，匹配航运场景的权限要求 |
maxResponseSize | 2048 千字节 | 限制单条分享接口的响应数据体量，避免传输超时或页面加载缓慢 |
cacheControlHeader | max-age=3600 或 max-age=86400 | 匹配数据更新频率，降低重复请求的服务器负载 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：分享链接访问后未触发授权流程，直接展示全量数据，原因：
shareAuthType配置为public，未开启基于令牌的授权模式，无法满足需要权限控制的航运数据分享需求。 - 现象：工作流中无法通过代码获取分享应用的URL地址，原因：未启用
workflowShareUrlEnable开关，或使用的FastGPT版本低于v4.9.7，该功能在对应版本中新增。 - 现象：不同浏览器访问同一嵌入链接，返回的用户标识不一致，原因：未配置基于会话的用户身份校验，或嵌入页面的Cookie策略未统一，导致浏览器间的会话状态无法同步。
怎么确认配好了
- 复制生成的分享链接，在嵌入域名对应的浏览器中打开，检查是否能正常加载目标港口的收益率数据，且数据单位与字段完整。
- 在工作流中调用生成分享URL的节点，检查返回的链接格式正确且可正常访问，确认是否携带了所需的港口代码参数。
- 查看FastGPT后台的
shareLog日志，检查分享请求的响应状态码为200 OK，无数据截断或跨域报错。 - 调整
shareExpireTime的取值，验证过期后的链接是否返回过期提示，确认缓存策略生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。