这个品类的数据长什么样
身份证件KYC的数据主要来源于公安身份核验接口、用户上传的实体证件扫描件或实拍照片。结构化数据包含姓名、18位身份证号码、性别、民族、户籍住址、签发机关、有效期限等固定字段，非结构化数据为证件正面与反面的图像文件。数据更新节奏由数据源决定，公安接口数据同步周期固定，用户上传的非结构化数据仅在单次核验中有效，不会长期留存。字段格式有明确规范，身份证号码需符合GB 11643-1999标准，有效期限为标准日期格式。
这些特征在「HTTP 接口与外部系统」这一环带来什么约束
身份证件的结构化字段格式有明确规范，非结构化数据为图像文件，且数据源存在调用频次限制。这些特征要求FastGPT的HTTP组件需支持两种入参形式：结构化字段的JSON校验与非结构化文件的表单提交。接口入参需添加身份证号正则校验、日期格式校验逻辑，过滤无效请求。同时需适配数据源的调用频次限制，配置请求防抖与重试机制，避免触发第三方接口的限流规则。此外，图像文件的尺寸与格式限制，要求外部系统在调用前完成格式转换与大小校验，确保符合第三方接口的接收要求。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
http_request_timeout | 30 秒 | 身份证件核验的第三方接口通常响应在10-20秒，预留足够缓冲避免超时中断 |
multipart_upload_enabled | 是 | 身份证件图像文件需通过表单形式提交，符合第三方KYC接口的上传要求 |
param_validation_strictness | 严格模式 | 身份证件字段格式有强制规范，严格校验可提前过滤无效请求，降低第三方接口的错误调用次数 |
retry_max_times | 2 次 | 第三方KYC接口可能存在临时抖动，少量重试可提升核验成功率，避免单次请求失败 |
response_parse_mode | 结构化字段映射 | 身份证件KYC返回的结构化数据需精准映射到预设字段，避免解析混乱 |
file_size_limit | 5 MB | 身份证件扫描件或实拍照片的常规大小不超过2MB，预留合理缓冲空间 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：HTTP调用时返回
getaddrinfo ENOTFOUND错误，无法完成请求。原因：外部系统配置的KYC接口域名填写错误，或该域名无法被公网正常解析。 - 现象：从HTTP组件解析出的boolean类型字段，进入条件判断组件后变为空值。原因：未配置响应字段的类型映射，第三方接口返回的布尔值被识别为文本类型，无法被条件判断组件识别。
- 现象：身份证件核验流程提前终止，返回格式不匹配错误。原因：未开启参数校验的严格模式，未对身份证号字段添加符合GB 11643-1999的正则校验规则，导致无效字段进入后续流程。
怎么确认配好了
- 发起单次测试调用，传入符合规范的身份证件结构化数据与图像文件，查看HTTP请求的完整日志，确认入参格式与第三方接口要求一致。
- 模拟第三方接口返回限流、超时等错误场景，验证重试机制与错误捕获逻辑是否正常生效。
- 配置条件判断组件，传入解析后的布尔类型字段，确认组件可正确识别字段值并执行对应逻辑。
- 检查外部系统的域名配置，确认填写的接口地址无拼写错误，且可被当前环境正常访问。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。