- 最新动态
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- API参考
-
常见问题
- 常见问题导航
- 计费
- 使用限制
- 定向
- 购买
- 物流
- 激活
- 流量查询
-
物联网卡管理
- 如何查询购买的物联网卡的卡号、MSISDN等基本信息?
- 怎样绑定设备?
- 绑定设备后还能更换设备吗,怎样解绑?
- 物联网卡是否支持通用流量?
- 运营商的APN是多少?
- 客户物联网卡丢失,如何进行补卡?
- 物联网卡基本信息怎么导出?
- 请问NB卡跟普通物联网卡有什么区别?
- 业务受理周期一般需要多久处理(批量激活/停机/复机等)?
- 物联网卡已经在使用了,后台显示可测试/可激活?
- 个人实名认证卡在未实名认证下,直接上电后,卡处于什么状态?这个时候会否还没有计算使用周期?
- 卡处于未实名认证停机状态时,做了实名认证后上电,卡是不是就能使用了?
- 物联网卡收到了控制台怎么看不到卡数据?
- 如何重置网络?
- 为什么物联网卡网络信号弱?
- 为什么SIM卡定位失败?
- 是否支持物联网卡的定位信息?
- 中国移动SIM卡的使用区域如何换绑到目标区域?
- 无法使用/停机/复机
- 账号
- 续费
-
流量池
- 怎么查看是否有使用流量池?单卡流量上限是多少?
- 怎样查看流量池的总流量、已用流量以及剩余流量?
- 非流量池订单购买后是否可以修改为流量池订单?
- 前向流量池订单购买后可以取消流量池吗?
- 如果当月流量超出,前向流量池里的所有卡都会停机吗?有什么方式能够充值流量?
- 可以把前向流量池里的部分卡改成非前向流量池的单卡套餐吗?
- 如果下单时开通了流量共享,后期使用中是否能关闭流量共享,变为单张卡独立流量?
- 同一个订单物联网卡,能否划分到不同的流量池中?
- 前向流量池的卡是激活一张全部都激活吗?
- 通过激活物联网卡来贡献流量如何操作呢?
- 为什么物联网卡无法加入流量池?
- 为什么激活了前向流量池后物联网卡还是显示已停用?
- API接口
- 通知
- 文档下载
- 通用参考
链接复制成功!
新增网络切换策略
功能介绍
新增网络切换策略
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/network-switch-policies
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
policy_name |
否 |
String |
策略名称 最大长度:32 |
preferred_carrier |
否 |
Integer |
仅对SDK版本生效。最优选运营商,1:移动、2:电信、3:联通、4:上次使用的运营商 最小值:1 最大值:4 缺省值:3 |
least_preferred_carrier |
否 |
Integer |
仅对SDK版本生效。最不优选运营商,1:移动、2:电信、3:联通 最小值:1 最大值:3 缺省值:2 |
optimal_signal |
否 |
Boolean |
仅对SDK版本生效。最优信号选取策略是否开启,true:开启,false:不开启 缺省值:false |
auto_switch |
否 |
Boolean |
仅对SDK版本生效。自动切卡是否开启,true:开启,false:不开启 缺省值:false |
weak_signal_switch |
否 |
Boolean |
仅对SDK版本生效。弱信号切换策略是否开启,true:开启,false:不开启 |
connect_ip |
否 |
String |
仅对SDK版本生效。连接延时切换策略,连接延时时需要ping的ip地址 最大长度:64 |
version |
是 |
Integer |
版本枚举,1:SDK版,2:无SDK版 |
switch_order |
否 |
String |
仅对无SDK版本生效。切卡顺序,运营商以英文逗号分隔,1:移动,2:电信,3:联通 最大长度:10 |
blacklist |
否 |
Integer |
仅对无SDK版本生效。黑名单,只支持单个运营商,1:移动,2:电信,3:联通 最小值:0 最大值:3 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
- |
Boolean |
OK |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最大长度:64 |
error_msg |
String |
错误描述 最大长度:512 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最大长度:64 |
error_msg |
String |
错误描述 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最大长度:64 |
error_msg |
String |
错误描述 最大长度:512 |
请求示例
-
新增无SDK版本三网卡策略
POST https://{endpoint}/v1/network-switch-policies { "policy_name" : "testaa", "version" : 2, "blacklist" : 1, "switch_order" : "3,1,2" }
-
新增SDK版本三网卡策略
POST https://{endpoint}/v1/network-switch-policies { "policy_name" : "test_sdk", "version" : 1, "preferred_carrier" : 3, "least_preferred_carrier" : 2, "blacklist" : 0, "optimal_signal" : true, "auto_switch" : true, "weak_signal_switch" : true, "connect_ip" : "www.example.com" }
响应示例
状态码: 400
Parameter Invalid
{ "error_code" : "GSL.00010001", "error_msg" : "参数异常" }
状态码: 403
Forbidden
{ "error_code" : "GSL.00010002", "error_msg" : "请求的内容不存在" }
状态码: 500
Internal Server Error
{ "error_code" : "GSL.00010004", "error_msg" : "系统繁忙,请稍后重试。" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Parameter Invalid |
403 |
Forbidden |
500 |
Internal Server Error |
错误码
请参见错误码。