不用 MCP 也能接：一个工厂数据 REST API 的快速上手（附 curl 示例）

MCP 很热但生产系统里大量场景还是老老实实的 HTTP 调用定时任务、后端服务、数据管道都不需要也不适合挂一个 MCP 客户端。天下工厂开放平台的设计在这点上比较务实——同一套能力MCP 和 REST 双通道等价开放这篇只讲 REST 这条路从签发密钥到跑通第一个请求。先介绍一下数据源天下工厂是一个覆盖全国 480 万家工厂的数据库与通用工商数据平台的差别在于收录前做了工厂身份识别只收真实从事生产的工厂贸易商和空壳类主体不进库。开放平台把它开放成五个能力factory_search检索、factory_detail档案、factory_contact联系电话、factory_deepdiveAI 深挖单厂、factory_agent_search自然语言检索。第一步拿密钥开发者控制台自助签发https://www.tianxiagongchang.com/open/console注册即送体验额度。也可以先用公开沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a空手验证——沙箱返回静态示例数据不计费。第二步第一个请求所有能力走同一个 URL 模式POST https://open.tianxiagongchang.com/open/v1/capabilities/能力名请求体就是能力的入参 JSON。查宁波的注塑模具工厂curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_search\-HAuthorization: Bearer$TIANXIA_API_KEY\-HContent-Type: application/json\-d{keyword:注塑模具,province:浙江省,city:宁波市,per_page:10}响应是统一格式{code:0,message:ok,request_id:req_...,credits_charged:400,credits_balance:123600,data:{total:1234,page:1,per_page:10,items:[{id:123456,name:...,region:...,industry:...,product:...}]}}code: 0是成功其余都是错误。注意一个设计细节REST 通道的 HTTP 状态码会跟随业务码比如余额不足时 HTTP 也是 4xx但判断成败的权威永远是响应体里的code写客户端代码时别只看 HTTP 状态。第三步串起一个漏斗拿到检索结果后items里的id就是后续所有能力用的company_id# 看某一家的完整档案curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_detail\-HAuthorization: Bearer$TIANXIA_API_KEY\-HContent-Type: application/json\-d{company_id:123456}# 只对入围的调联系电话同一家重复解锁不再计费curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_contact\-HAuthorization: Bearer$TIANXIA_API_KEY\-HContent-Type: application/json\-d{company_id:123456}建议的调用顺序是「检索、筛短名单、看档案、末端才解锁电话」——factory_contact是单价最高的能力把它放在漏斗末端能省不少额度。计费是按量的单次以角计价每个响应都带credits_charged与credits_balance成本完全透明。几个工程注意事项入参严格校验未知字段直接40000拒绝不静默忽略。拼错字段名会立刻暴露这比「参数悄悄失效」好排查得多。限流常规能力每分钟 300 次factory_deepdive和factory_agent_search共享每分钟 6 次的慢速通道factory_contact额外限 1 QPS、每应用每天 500 次。超限返回42900且不扣费用固定指数退避1 秒、2 秒、4 秒重试即可。超时设置检索、档案、电话 30 秒足够深挖和自然语言检索是长任务客户端超时要设到 120 秒和 180 秒以上默认 10 秒超时会把正常执行掐断看起来像服务挂了其实是自己掐的。机器可读的 OpenAPI 3.1 规范公开在GET https://open.tianxiagongchang.com/open/v1/meta/openapi.json无需密钥可以直接喂给 Swagger UI 或代码生成器。人类可读的完整文档在 https://www.tianxiagongchang.com/open/docs。有 curl 就能开始五分钟内可以跑通第一个请求。