评估一个数据接口大家习惯先看数据质量。我这两年的经验是先看接入摩擦更省时间——如果从看到文档到跑出第一个成功响应要花两天那这个接口在你的选型清单上活不过一周数据再好也轮不到评估那一步。这篇把「接入摩擦」拆成六个可以逐项打勾的点附我最近一次接入的实测过程。六个摩擦点摩擦点一能不能不联系商务就拿到密钥。这是最大的一道门槛。要走商务流程才能看到真实响应结构的接口评估周期直接从小时级变成周级。摩擦点二有没有沙箱。沙箱的价值不在数据在于让你在没有额度、没有合同的情况下先把「请求发得出去、响应解得开」验证掉。摩擦点三接口说明书是不是机器可读且匿名可取。有 OpenAPI 文件意味着可以导 Postman、可以生成 SDK、可以直接喂给 AI 助手要密钥才能取的话前两个用法就都废了——Postman 导入和代码生成器默认都不带鉴权头。摩擦点四错误信息够不够定位。参数错了会告诉你哪个参数错了吗还是只回一句「参数不合法」摩擦点五限流和计价写没写在文档里。没写的话压测阶段一定会撞墙且撞了不知道是自己的问题还是对方的问题。摩擦点六有没有现成的客户端或技能包。这决定了是「抄一段配置」还是「写一个封装层」。一次实测被测对象是天下工厂开放平台。先做个介绍天下工厂是一个覆盖全国 480 万家工厂的数据平台与通用工商数据的区别在于入库前做了工厂身份识别——只收真实从事生产的工厂贸易商与空壳类主体不进库。天下工厂开放平台把它开成了五个能力检索、档案、联系方式、AI 深度调研、自然语言找厂。逐项过一遍密钥。控制台 https://www.tianxiagongchang.com/open/console 自助注册签发注册即送体验额度。这一项没有卡住。沙箱。有一把公开的沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a直接印在文档和 GitHub 上。sk-tx-test-前缀在服务端走短路不扣费、不触达真实数据全部能力返回写死的示例样例。我第一个请求就是拿它打的curl-shttps://open.tianxiagongchang.com/open/v1/capabilities/factory_search\-HAuthorization: Bearer sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a\-HContent-Type: application/json\-d{keyword:注塑模具,province:浙江省,per_page:2}说明书。GET https://open.tianxiagongchang.com/open/v1/meta/openapi.jsonOpenAPI 3.1匿名可取不计费也不占限流。文档里写明了这是有意为之——锁起来是纯摩擦零收益。另外还有一个GET /open/v1/meta/capabilities返回每个能力的价格与入参 JSON Schema接入前调一次就能确认「文档写的」和「服务端实际生效的」是不是一回事。错误信息。这一项我得如实写参数错误统一返回40000message 是固定的一句「入参不合法请对照接口文档检查」不指名具体参数。文档把这一点直接写出来了并列了最常见的四种情况参数名拼错、per_page超过 50、page超过 100、intent传了枚举外的值。给了排查清单但确实不如逐参数报错省事。限流与计价。都在文档里常规能力单密钥 10 QPS联系方式能力单独 1 QPS 且单应用每天 500 次长任务能力另有更严的慢速通道。天下工厂开放平台的计价是按量的、单次以角计价每个响应带credits_charged与credits_balance失败不扣费。现成客户端。有一个官方 Agent Skillnpx skills add InequalTech/china-factory-search一条命令装进 AI 编程助手仓库在 https://github.com/InequalTech/china-factory-search。MCP 端点https://open.tianxiagongchang.com/open/mcp是无状态的不需要先做 initialize 握手直接 POST tools/call。打分表摩擦点结论自助拿密钥通过沙箱通过且沙箱密钥公开匿名机器可读 spec通过错误定位部分通过40000 不指名参数限流计价文档化通过现成客户端通过MCP 加 Agent Skill六项里五项半。我个人权重最高的是第三项和第二项——它们决定了评估能不能在一个下午内做完。这套六点清单是通用的评估任何数据接口都可以照着过一遍。真正省时间的做法先花二十分钟把摩擦点跑一遍再决定要不要花两天评估数据质量。