物联渠道

更新时间：2025-05-18

• 物联裸卡、设备的渠道（通道）配置对接统一在【渠道管理】 → 【物联渠道】中管理维护。
• 开始之前，请确认你已了解渠道的前置功能：
• 点我查看-实名方案

渠道类型说明

物联渠道根据接入场景不同，分为以下四种类型：

渠道类型	适用场景
裸卡渠道	对接普通物联网裸卡（SIM卡），同步流量、执行停复机等
设备渠道	对接物联网设备管理平台，同步设备在线状态、信号、电量等
设备卡渠道	对接设备内 SIM 卡的流量管理平台，同步卡流量、执行卡控操作
设备方案	将设备渠道 + 设备卡渠道组合绑定，以及设备的非固定配置参数设置，作为设备接入的配置模板

裸卡和共享池接入 只需配置裸卡渠道。

设备接入 需要配置设备渠道 + 设备卡渠道，再通过设备方案组合起来。如果设备渠道本身已包含流量管理能力，设备卡渠道可以不配置，设备方案中的设备卡渠道选择跟随设备渠道即可。

裸卡渠道

裸卡渠道用于对接普通物联网裸卡（SIM卡），平台通过该渠道定期查询卡板流量、执行停机、复机、套餐充值等操作。

添加渠道

这里以同系统移动流量池对接为例：

其他渠道

其他渠道的参数填写可以参考本页下方的公开渠道对接说明，如果没有可联系商务确认对接参数填写方式。

轮询设置

轮询设置用于渠道数据同步，默认参数可直接对接使用。若渠道卡量多、存在频次限制或接口异常等特殊情况的，可按需调整参数，规避调用异常。

参数名称	说明
动态轮询	默认开启，关闭后所有渠道接口将停止调用
轮询卡模式	平台营运充值套餐包的卡板建议选择”已充值卡“，放共享池卡需选择”所有卡“
轮询等级	默认4-6，想快点建议：2-6，想慢点建议：8-8
轮询线程数	默认5个，越大同时轮询的卡板数量越多。当渠道卡板多的时候可上，最大到 200；当渠道限制频次时可适当调低到：2-3
轮询重试	单次请求轮询失败时，系统自动对特定可重试的状态码进行重试的次数。 当渠道卡板多的时候可调到：1
连接超时	默认30秒，当渠道接口太慢出现大规模超时造成任务积压时，可根据正常的平均请求成功时长压低超时时间，以换取整体更快的轮询
加入失败队列	如果轮询失败，系统会单独加入到快速重试队列中，用于提高轮询成功率。卡多的渠道不建议开
代理服务器	当渠道有IP白名单时，若你服务器 IP 不在白名单，或需要由多个 IP 轮询请求接口时可配置
禁用接口	上游不支持的接口必须禁用掉，否则系统会一直请求产生不必要的错误日志，会严重干扰查看其他正常日志，浪费系统性能并失去日志排查能力
实名后操作	联通卡若开启了先充值后实名，则需要勾选【自动复机】，否则用户实名后卡板是停机状态。其他营运商实名后会自动复机无需配置
eSIM卡	仅支持eSIM卡，可设置eSIM自动写卡方式

更多相关说明请参考：动态轮询

回调地址

若对接渠道支持通过回调的方式获取数据，可在渠道添加成功后通过右侧操作栏【编辑】查看回调地址，以便进行配置

设备渠道 / 设备卡渠道 / 设备方案

三者关系

名称	作用
设备渠道	管"设备本身"，负责同步设备WiFi信息、切换网卡、重启/关机/重置设备、在线/离线状态、信号、电量、地理位置等设备层面的信息。
设备卡渠道	管"设备里的卡"，负责同步卡板流量使用情况，执行停复机、套餐充值等卡控操作。
设备方案	将设备渠道和设备卡渠道绑定在一起，形成一个完整的设备接入配置模板。

设备方案 = 设备渠道 + 设备卡渠道的组合配置。实际在设备入库时，需要选择绑定设备渠道和设备方案。

单渠道情况

部分设备渠道同时提供设备管理和卡流量管理能力（一个渠道管全部），此时设备卡渠道可以不配置，设备方案中的设备卡渠道选择跟随设备渠道即可。

添加设备渠道

这里以同系统设备对接为例：

添加设备卡渠道

这里基本和裸卡渠道一样，只多了”二次认证“参数选项，如果卡板需要二次认证，则需要开启，其他的参考裸卡渠道的说明即可。

添加设备方案

添加一个设备方案，将设备渠道和设备卡渠道进行绑定组合。这里主要是选择下设备网络模式和卡槽的营运商、卡槽的渠道设置，其他的看情况设置即可。

设备方案的优势

同批次设备存在卡槽、渠道、网络参数差异，可创建多种设备方案供入库时选用，已入库设备也支持二次修改方案，实现设备灵活管控。

渠道日志

我方为渠道对接提供了一套完善的日志服务，可以查询任意渠道的任意次对接情况，便于发现和排查渠道异常问题

每次渠道调用结果都支持在线查询，也可以通过终端工具二次快速调试

公示渠道

• 这里只对部分良好并且在积极维护的渠道进行教程公示。如果以下没有找到需要对接的渠道信息，请联系官方客服获取对接教程或定制对接

渠道名称	渠道编码	加入时间	操作
飞仕（同系统对接）	GMY	2023年8月	查看
移动OneLink	OneLink	2023年11月	查看
联通蜂窝	UniComGw	2023年11月	查看
电信5GCMP	Telecom5GCMP	2023年9月	查看
广电CbLink	CbLink	2024年8月	查看
广东广电	GDCbn	2023年8月	查看
上海广电	SHCbn	2023年9月	查看

飞仕

• 渠道编码：GMY

所有使用本系统的平台，均可通过飞仕渠道进行互通接入

1. 获取对接方对接配置信息

登录对接方平台，找到【系统设置】-【个人设置】-【开放API对接】

2. 添加配置信息到渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：飞仕
渠道编码：GMY
渠道对接地址：https://haokav2.facms.cn
渠道密钥ID：10000
渠道密钥：S6PjY0U4WOUCF8jHhaWHdAgJlBCyxT6Q
自定义参数1：8meNVtIY
自定义参数2：FTYUI

移动OneLink

• 渠道编码：OneLink

移动官方流量池，也可以对接第三方移动token

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：移动OneLink
渠道编码：OneLink
渠道对接地址：https://api.iot.10086.cn
渠道密钥ID：如果是官方池直接对接，填移动后台的APPID
渠道密钥：如果是官方池直接对接，填移动后台的接入密码
若是第三方token对接，还需要配置token选项

• 如果是官方池直接对接，请到下图位置找到APPID和接入密码

• 如果是官方池直接对接，还可以配置实名登记推送。卡板实名后实时将实名结果推送到我方系统，优化用户体验

联通蜂窝

• 渠道编码：UniComGw

登录联通二级户查看对接配置：

登录地址（非对接地址！）：https://gw.10646.cn

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：联通蜂窝
渠道编码：UniComGw
渠道对接地址：https://gwapi.10646.cn
渠道密钥ID：APPID
渠道密钥：APP SECRET生产，不要填APP SECRET生产沙箱！
自定义参数1：创建者openID

电信5GCMP

• 渠道编码：Telecom5GCMP

电信5GCMP https://www.ctwing.cn

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：电信5GCMP
渠道编码：Telecom5GCMP
渠道对接地址：https://cmp-api.ctwing.cn:20164
渠道密钥ID：APP_KEY
渠道密钥：APP_screct

广电CbLink

• 渠道编码：CbLink

广电CbLink https://cblink.10099.com.cn

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：广电CbLink
渠道编码：CbLink
渠道对接地址：https://cblink.10099.com.cn	
渠道密钥ID：不填
渠道密钥：不填
自定义参数1: access_token
自定义参数2: refresh_token
自定义参数3: token有效期，如：2024-12-14 06:56:18

广东广电

• 渠道编码：GDCbn

广东广电，正规广电卡渠道

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：广东广电
渠道编码：GDCbn
渠道对接地址：https://xx.cn	
渠道密钥ID：clientAppId
渠道密钥：clientSecret

上海广电

• 渠道编码：SHCbn

上海广电，二级户对接

添加渠道

示例信息，除渠道编码外请替换成你实际的对接方信息

渠道名称：上海广电
渠道编码：SHCbn
渠道对接地址：https://xx.cn	
渠道密钥ID：appId
渠道密钥：appsecret