常见问题 FAQ
关于账号开通、AppKey / 访问 Key、免费试用、计费充值与接口调用、NMS 消息服务的常见问题解答。
账号与开通
如何开通数据接口？
在「数据API」列表找到所需接口，进入详情页点击「开通」，支持余额扣费或免费试用。开通后在控制台「我的接口」中查看已开通接口。
免费试用怎么用？
部分接口开放免费试用，登录后进入接口详情页即可领取，无需付费。试用次数用完后自动按正常价格计费。
AppKey 和 AppSecret 是什么？
它们是平台的身份凭证。调用时在请求头同时携带 X-AppKey 与 X-AppSecret 即可完成认证，开箱即用。
什么是自定义访问 Key？
在「我的账户」中可新增多个访问 Key，调用接口时只需携带 key 参数（URL query 或请求头 X-Key）即可认证，无需签名。适合小程序、网页、脚本等轻量接入，每个 Key 的调用量可分别统计。
计费与发票
按次和包月有什么区别？
按次：每次调用从余额扣减对应金额。包月：开通后在有效期内按月计费，每月调用次数以接口详情页标注为准（部分不限次数，部分设每月上限）。
余额怎么充值？
登录控制台后在「充值中心」选择金额完成充值，支持微信与支付宝，充值记录可在「财务中心」查看。
调用失败会扣费吗？
只有调用成功（code=0）才会计费。余额不足、接口未开通、认证失败等错误调用不会扣费。
接口调用
接口调用地址是什么？
接口地址为 /api/data/{接口编码}。各接口支持的请求方式见接口详情页（GET：参数拼 URL query；POST：参数以 JSON 放请求体），多数接口两种方式均支持。
服务端调用如何认证？
无需签名。方式一（推荐）：携带自定义访问 Key，GET/POST 在 URL 中加 key 参数（或请求头 X-Key）即可；方式二：请求头同时携带 X-AppKey 与 X-AppSecret。
返回 code 5001 是什么意思？
表示账户余额不足，请前往「充值中心」充值后重试。
返回 code 5003 是什么意思？
表示接口未开通或已停用，请在「我的接口」中重新开通该接口后再调用。
NMS 消息服务
NMS 支持哪些接入方式？
支持 WebSocket、TCP Socket、MQTT 三种协议。TCP 使用换行分隔的 JSON 帧，MQTT 支持标准 3.1.1（QoS 0/1），接入指南见「API文档」。
不同服务之间会串消息吗？
不会。每个消息服务使用独立的 AppKey/AppSecret，服务之间完全隔离，主题互不互通。
连接数上限是多少？
受套餐限制：免费版 10 个连接、标准版 100 个、专业版 1000 个。超过上限会返回「已达套餐最大连接数限制」。