写筛选参数之前，先把这两棵树拿到手：行政区划与行业分类字典接口

对接任何带筛选的数据 API，最容易被低估的工作是「合法取值从哪来」。地区写「浙江」还是「浙江省」？行业该传名称还是编码？猜错的代价轻则查不到数据，重则查到错的数据还不自知。这篇讲天下工厂开放平台处理这个问题的方式：两个免费的字典接口，以及一个「绝不静默容错」的设计选择。

先交代数据源：天下工厂是一个覆盖全国 480 万家工厂的数据库，做了工厂身份识别（真实生产的工厂才收录），开放平台提供检索、档案、联系电话、AI 深挖、自然语言检索五个能力，文档在 https://www.tianxiagongchang.com/open/docs。

两个字典接口

GET https://open.tianxiagongchang.com/open/v1/meta/regions GET https://open.tianxiagongchang.com/open/v1/meta/industries

带任意有效密钥即可访问，不计费。前者返回省、市、区县三级行政区划树（官方标准名称），后者返回四级行业分类树——这就是检索能力里province、city、district、industry四个参数的合法取值来源。

用法上的正确姿势是：应用启动时拉一次、本地缓存，筛选界面直接用这两棵树渲染级联选择器，用户选什么就传什么。永远不要让用户（或者你的代码）手拼地区名。

行业码的一个好设计：前缀展开

行业参数industry接受的是行业分类编码，比如C35是一个大类，C3591是它下面的细分。这里有个省心的设计：传父级编码会自动展开整棵子树——传C35，命中的是 C35 及其全部下级行业的工厂，不需要你把几十个叶子码逐个列出来 OR 起来。

curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_search\-H"Authorization: Bearer$TIANXIA_API_KEY"\-H"Content-Type: application/json"\-d'{"keyword":"减速机","industry":"C34"}'

行业筛选和关键词是交集关系：上面这个请求找的是「行业挂在 C34 子树下、且产品与减速机相关」的工厂。行业码收窄行业面，关键词定位具体产品，两个维度配合用，比单用任何一个都准。

「不认识就报错」比「猜一个」好

传一个不存在的行业码会怎样？返回code: 40000，明确报错。不会静默忽略这个筛选条件然后返回全量结果。

这个设计值得展开说。很多 API 对不认识的参数值选择宽容处理——忽略掉，返回「能返回的」。短期看似友好，实际是埋雷：你以为在查某个细分行业，实际拿到的是无筛选的全量，数字大得漂亮，分析结论全错，而且没有任何报错提醒你。严格模式把这类错误从「上线后数据不对」提前到「开发时立刻炸」，排查成本差几个量级。同样的严格性也适用于整个入参层：未知字段一律40000拒绝。

实际对接清单

1. 启动时拉/meta/regions与/meta/industries，本地缓存（字典变化频率很低，日级缓存足够）；
2. 筛选参数只从字典取值，地区用全称（"浙江省"、"宁波市"）；
3. 行业筛选优先传父级码，靠前缀展开覆盖子树，需要更细再下钻；
4. 把40000当成开发期信号处理：一定是参数拼错或字典没对齐，修参数，别重试。

密钥在控制台自助签发（https://www.tianxiagongchang.com/open/console，注册即送体验额度），公开沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a可用来先看字典接口的返回结构。另外，OpenAPI 3.1 规范在GET https://open.tianxiagongchang.com/open/v1/meta/openapi.json匿名可取，字典、能力、错误码在规范里都有完整定义。

字典接口不起眼，但它决定了你的筛选参数是「构造出来的」还是「猜出来的」。先拿树，再传参，这个顺序养成习惯，能省掉后面很多莫名其妙的查询问题。