开放API-二次开发-有人云

## 登录接口

### 请求说明

- **URL**：`https://sim.usr.cn/api/v1.Token/getTokenByAppKey`
- **请求方式**：POST
- **consumes**：application/json

### 请求参数
| 参数 | 说明 | 类型 | 必填 |
| ------------ | ------------ | ------------ | ------------ |
| appkey |  appkey   | String | true |
| token | 密钥token，非接口通信token | String | true |

### 请求示例
```json
{
	"appkey": "aaa",
	"token": "bbb"
}
```

### 响应参数
| 参数 | 说明 | 类型 |
| --- | --- | --- |
| data | 数据内容 |  |
| token | 接口通信token，有效期2小时 | string |
| info | 提示信息 | string |
| status | 状态，200成功，400失败 | int32 |

### 成功响应示例
```json
{
  "status": 200,
  "info": "获取成功",
  "data": {
    "token": "eyJhbGcLCJh8DdJ4..."
  }
}
```

### 失败响应示例
```json
{
  "status": 400,
  "info": "appkey和token 错误"
}
```

### 注意事项
获取到的token，有效期为2小时。

## 获取卡信息接口

### 请求说明

- **URL**：`https://sim.usr.cn/api/v1.AssetCard/getAssetCardList`
- **请求方式**：POST
- **consumes**：application/json

### 请求参数
| 参数 | 说明 | 类型 | 必填 |
| ------------ | ------------ | ------------ | ------------ |
| limit | 每页数量(最大支持1000) | int32 | true |
| offset | 偏移量 | int32 | true |
| search | 卡号/iccid（精确搜索） | string | false |
| token | token放置在header中 | string | false |

### 请求示例
```json
{
	"limit": 10,
	"offset": 0,
	"search": "898611100000000",
	"token": "eyJhbGciOTY1OTYxud47Pew..."
}
```

### 响应参数
| 参数 | 说明 | 类型 |
| --- | --- | --- |
| data | 数据列表 | |
|    count | 总数 | int64 |
|    list | 当页数据 | array |
|        activation_time | 激活日期 | string |
|        add_pool_time | 添加流量池时间 | string |
|        card_status_id | 卡状态id | string |
|        content | 卡状态 | string |
|        device_imei | 设备imei | string |
|        device_sn | 设备sn | string |
|        end_time | 到期日期 | string |
|        flow_rate | 主套餐流量 | string |
|        iccid | iccid | string |
|        id | id | int32 |
|        is_auto_renew | 是否自动续期，0：否，1：是 | int32 |
|        is_monitor | 是否监控 | string |
|        is_warn | 是否预警 | int32 |
|        label | 标签 | string |
|        msisdn | 卡号 | string |
|        oa_order_id | 批次号 | string |
|        operator_name | 运营商名称 | string |
|        package_name | 套餐内容 | string |
|        package_type | 卡类型 | string |
|        package_type_id | 卡类型id | string |
|        parent_account | 父级账号名称 | string |
|        prd_code | 流量池编码 | string |
|        price | 价格 | string |
|        psm_type | psm状态 | string |
|        record_flow_rate | 剩余流量百分比 | string |
|        remarks | 备注 | string |
|        series | 系列 | string |
|        surplus_flow | 剩余流量 | string |
|        time | 更新时间 | string |
|        total_flow | 总流量 | string |
|        use_flow | 使用流量 | string |
| info | 提示信息 | string |
| status | 状态，200成功，400失败 | int32 |

### 成功响应示例
```json
{
  "status": 200,
  "info": "获取信息成功",
  "data": {
    "count": 1,
    "list": [
      {
        "id": 1272721,
        "iccid": "898611100000000",
        "msisdn": "1410336344941",
        "activation_time": "2022-04-24",
        "end_time": "2023-07-01",
        "remarks": "添加的第一张卡：  测试",
        "oa_order_id": "000000",
        "is_monitor": "关闭",
        "time": "2022-08-03 00:07:18",
        "psm_type": "未知",
        "device_sn": "",
        "device_imei": "",
        "card_status_id": "1",
        "price": "195.00元/年",
        "flow_rate": "4.0GB/年",
        "package_type": "年卡",
        "package_type_id": "2",
        "content": "正常",
        "operator_name": "中国电信",
        "total_flow": "2.0GB",
        "surplus_flow": "1.85GB",
        "use_flow": "153.48MB",
        "record_flow_rate": "0.925058594",
        "series": "年套餐系列（4G非定向）",
        "is_warn": 0,
        "package_name": "4G/年",
        "label": "5455,标签111",
        "is_auto_renew": 0
      }
    ]
  }
}
```

### 失败响应示例
```json
{
  "account": null,
  "data": null,
  "info": "Token verification failed",
  "keyDesp": null,
  "status": 12
}
```