查询三网卡列表
功能介绍
通过cid或全量查询三网卡列表
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/sim-cards-multiply
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
cid |
否 |
String |
cid |
online_carrier |
否 |
Integer |
在线运营商标识 |
sim_card_id |
否 |
Long |
SIM卡标识 |
version |
否 |
Integer |
三网卡版本信息 1:SDK版 2:无SDK版 |
limit |
否 |
Long |
分页查询时每页显示的记录数,默认值为10,取值范围为10-500的整数 |
offset |
否 |
Long |
分页查询时的页码数,默认值为1,取值范围为1-1000000的整数 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
limit |
Long |
每页记录数 |
offset |
Long |
页码 |
count |
Long |
总数 |
sim_cards |
Array of SimDeviceMultiplyVO objects |
三网卡数据集合 |
参数 |
参数类型 |
描述 |
---|---|---|
sim_card_id |
Long |
SIM卡标识 |
cid |
String |
三网卡标识 |
online_carrier |
Integer |
在线运营商标识 1:中国移动 2:中国电信 3:中国联通 |
network_switch_policy_id |
Long |
网络切换策略ID |
policy_name |
String |
网络切换策略名称 |
version |
Integer |
版本信息 1:SDK版 2:无SDK版 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
查询三网卡列表
GET https://{endpoint}/v1/sim-cards-multiply&version=2
响应示例
状态码: 200
OK
{ "limit" : 10, "offset" : 1, "count" : 1, "sim_cards" : [ { "sim_card_id" : "1234XXXXXX", "cid" : "13152562XXXXX", "online_carrier" : 1, "network_switch_policy_id" : 1111111111111111, "policy_name" : "默认策略无SDK版", "version" : 2 } ] }
状态码: 400
Bad Request
{ "error_code" : "GSL.00010004", "error_msg" : "参数异常" }
状态码: 500
Internal Server Error
{ "error_code" : "GSL.00010003", "error_msg" : "系统繁忙,请稍后重试。" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
500 |
Internal Server Error |
错误码
请参见错误码。