这个品类的数据长什么样
畜禽养殖企业的经营数据是金融机构开展获客营销的核心依据，主要来自三类源头：规模化养殖场的物联网饲喂/环控设备、养殖管理SaaS系统，以及地方畜牧技术推广站的公开统计数据。设备上报数据为实时增量流，养殖系统数据按日/周批量同步，畜牧站数据为月度批量更新。单条标准数据文档包含养殖场唯一标识、畜禽品类（猪、鸡、牛等）、存栏数量、当日饲料消耗量、舍内温湿度、数据采集时间戳。字段单位固定：存栏量以「头」或「羽」为单位，饲料消耗量以「千克」为单位，温湿度分别以「摄氏度」「百分比」为单位。
这些特征在「HTTP 接口与外部系统」这一环带来什么约束
多源数据的格式差异要求HTTP接口支持JSON、CSV及二进制设备上报三种数据格式，否则无法兼容设备与系统的接入需求。不同数据源的更新节奏跨度大，从分钟级到月度级，需要针对不同数据源配置差异化的轮询与同步策略，避免资源浪费或数据延迟。字段包含明确的品类与单位信息，接口需要严格匹配字段名与单位定义，否则会导致营销内容生成时出现单位混淆或品类匹配错误。养殖营销内容的时效性要求较高，部分实时推送场景要求数据延迟不超过30分钟，接口超时与重试策略需要适配这一要求。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
external_data_source_type | 混合模式（设备上报+系统同步） | 覆盖物联网设备的实时数据与养殖SaaS的批量同步数据 |
polling_interval | 15–60 分钟 | 匹配存栏数据每日更新、饲喂数据高频上报的节奏差异 |
field_mapping_rules | 按farm_id:养殖场ID,animal_type:畜禽品类,head_count:存栏量,unit:单位格式配置 | 匹配畜禽养殖数据的专属字段与单位定义，避免映射错误 |
api_timeout | 30 秒 | 满足养殖营销内容的实时推送时效要求 |
failed_retry_count | 3 次 | 应对物联网设备临时断连或系统接口波动的重试需求 |
share_link_user_id | 按接入的养殖企业ID注入 | 匹配免登录分享链接的用户标识需求 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 调用HTTP接口返回
400 Bad Request，提示tmbId字段缺失，原因是使用了较早的应用历史版本，未同步MongoAppVersion表的tmbId字段补全逻辑。 - 本地部署正常但OneApi调用失败，返回
502 Bad Gateway，原因是未配置外部系统的跨域白名单或端口映射错误。 - 生成的营销内容未匹配对应畜禽品类，原因是未按畜禽品类配置专属的字段权重，通用匹配逻辑无法区分猪、鸡等不同品类的营销需求。
怎么确认配好了
- 调用配置好的HTTP接口，检查返回的JSON数据包含所有配置的字段与正确的单位信息。
- 触发一次营销内容生成任务，查看外部系统是否收到符合预期的推送请求。
- 查看应用运行日志，确认无
tmbId缺失或接口超时类报错。 - 生成免登录分享链接，检查链接中携带了正确的用户数据库标识ID。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。