查询三网卡列表 - ListSimDeviceMultiply
功能介绍
通过cid或全量查询三网卡列表
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/sim-cards-multiply
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
order_id | 否 | Long | 订单号 最小长度：1 最大长度：20 |
cid | 否 | String | cid 最小长度：1 最大长度：20 |
iccid | 否 | String | iccid 最小长度：1 最大长度：20 |
online_carrier | 否 | Integer | 在线运营商标识 最小值：1 最大值：3 |
sim_card_id | 否 | Long | SIM卡标识 |
version | 否 | Integer | 三网卡版本信息，1:SDK版，2:无SDK版 最小值：1 最大值：2 |
limit | 否 | Long | 分页查询时每页显示的记录数，默认值为10，取值范围为10-500的整数 最小值：10 最大值：500 缺省值：10 |
offset | 否 | Long | 分页查询时的页码数，默认值为1，取值范围为1-1000000的整数 最小值：1 最大值：1000000 缺省值：1 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
limit | Long | 每页记录数 |
offset | Long | 页码 |
count | Long | 总数 |
sim_cards | Array of SimDeviceMultiplyVO objects | 三网卡数据集合 |
参数 | 参数类型 | 描述 |
|---|---|---|
sim_card_id | Long | SIM卡标识 |
cid | String | 三网卡标识 |
iccid_mobile | String | 移动网络iccid |
iccid_unicom | String | 联通网络iccid |
iccid_telcom | String | 电信网络iccid |
online_carrier | Integer | 在线运营商标识，1：中国移动 2：中国电信 3:中国联通 |
network_switch_policy_id | Long | 网络切换策略id |
policy_name | String | 网络切换策略名称 |
version | Integer | 版本信息，1:SDK版，2:无SDK版 |
order_id | Long | 订单号 |
状态码：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",
"iccid_mobile" : "89860061XXXXX",
"iccid_unicom" : "89860161XXXXX",
"iccid_telcom" : "8986033XXXXX",
"order_id" : 123456789,
"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 |
错误码
请参见错误码。
