文档首页/ 全球SIM联接 GSL/ API参考/ API列表/ 三网卡管理/ 查询三网卡列表
更新时间：2024-08-28 GMT+08:00
查看PDF
分享

查询三网卡列表

功能介绍

通过cid或全量查询三网卡列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/sim-cards-multiply

表1 Query参数

参数

是否必选

参数类型

描述

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

表2 响应Body参数

参数

参数类型

描述

limit

Long

每页记录数

offset

Long

页码

count

Long

总数

sim_cards

Array of SimDeviceMultiplyVO objects

三网卡数据集合
表3 SimDeviceMultiplyVO

参数

参数类型

描述

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

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码： 500

表5 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码。

父主题： 三网卡管理

相关文档