版本 cubeapi-20250102

日期：20250102

版本 cubeapi-20241227

日期：2024-12-27

REST API

优化

选择并锁定本地网络增加美国，310网络T-mobile，260

版本 cubeapi-2024081501

日期：2024-08-15

REST API

优化

添加套餐增加响应参数“order_id”

取消（异步）增加可选请求参数“order_id”

版本 cubeapi-2024062701

日期：2024-06-27

REST API

优化

1.查询异步操作结果，支持reset异步操作结果查询
2.查询特定SIM卡实时剩余用量，支持新资源查询

Notification API

新增

1.SIM卡IMEI变更通知

版本 cubeapi-2024030701

日期：2024-03-07

REST API

新增

恢复初始设置（异步）

版本 cubeapi-2024011801

日期：2024-01-18

Notification API

优化

SIM卡周期内流量用量推送增加流量池推送参数及示例

查询单张SIM卡详细信息接口优化：

查询SIM卡信息时sim_service.global_overage_policy节点中可展示SIM卡在当前周期内是否被流控

查询OTA卡时profile节点中imsi信息不准确修复

suspend、resume等接口响应头中request_id唯一性修复

版本 cubeapi-2023121901

日期：2023-12-21

REST API

新增

恢复（异步）（实际上线12-19）
取消（异步）

优化

查询单张SIM卡详细信息
批量获取组织下的SIM卡信息
以上API返回参数增加SIM首次激活时间activated_at

Notification API

优化

定制SIM卡实时用量推送
以上推送新增类型：
SIM data usage 9GB
SIM data usage 10GB & suspend IMSI

版本 cubeapi-2023120701

日期：2023-12-07

REST API

优化

添加套餐请求参数Header中增加可选参数Client-token

版本 cubeapi-2023112401

日期：2023-11-23

REST API

新增

查询特定SIM卡实时剩余用量

优化

通过ICCID查询单张SIM下行短信（MT）
通过Job ID查询批量SIM下行短信（MT）
下行短信状态成功、失败作为最终结果，且不变更，未接收到最终解决统一为处理中。

版本 cubeapi-2023110301

日期：2023-11-03

REST API

新增

在线续费，特定场景下的在线续费

查询续费订单，在线续费查询

优化

以下接口增加expire_at参数，代表SIM卡所有套餐（含未启用）预计结束时间
查询SIM卡下的套餐列表
查询SIM卡的可绑定套餐列表

文档优化

查询单张SIM卡实时状态文档目录转移

版本 cubeapi-2023103101

日期：2023-10-31

Notification

新增

1.定制SIM卡实时用量推送

更新

SIM卡状态变更推送支持由任意-->停机保前X天

API

更新

添加套餐新增activate参数，支持非OTA卡订购基础套餐时选择是否立即激活套餐

版本 cubeapi-2023102701

日期：2023-10-26

新增

查询SIM卡的可绑定套餐列表

版本 cubeapi-2023092201

日期：2023-09-21

新增

非OTA更换套餐

查询特定运营商SIM卡流量用量（A1）

更新

1.添加套餐
对特定运营商的SIM卡支持对补充套餐（加油包）的订购

版本2023082501

日期：2023082801

更新

批量获取组织下的SIM卡信息

入参增加sim_ids，参数可选，单次最大支持100个sim_id

可与其他参数组合查询，取交集返回数据
激活（异步）

文档描述文字

增加本接口主要的错误码描述

版本2023072001

日期：20230720

新增

新增API：查询SIM卡下的套餐列表

版本2023071301

日期：20230714

新增

新增Notification统一规范：签名计算、重试机制
新增Notification：短信上线回调（MO）

更新

引入Notification统一规范：SIM卡实时余量通知

版本2023061501

日期：20230615

更新

更新API批量获取组织下的SIM卡信息主要内容如下：
增加选参数order_id，可以根据客户（销售）订单查询订单下的SIM卡列表。
此处的order_id特指通过API在线下单产生的订单号。

新增

新增API如下：
获取组织下的产品列表
获取覆盖地组合规格
在线下单
查询订单

版本2023052301

日期：20230523

更新

更新API添加套餐主要内容如下：

bundle_type变更为选填，默认值：10-基础套餐。

bundle_id变更为选填，且当用户传入为空时，系统将按照固定规则选择一个SIM卡曾经绑定过的套餐进行绑定。

系统自动选择套餐的范围仅为基础套餐。

系统自动选择套餐的规则如下：

首先查询SIM卡当前所有订购过的套餐列表

其次按状态对套餐进行排序，按状态优先选取一个套餐，套餐状态优先级如下：

使用中 > 已暂停 > 未启用 > 已结束

当同一状态有多个套餐时，按照时间进行排序，优先级如下：

多个使用中：取启用时间距离当前最近的。

多个已暂停：取暂停时间距离当前最近的。

多个未启用：取订购时间距离当前最近的。

多个已结束：取结束时间距离当前最近的。

多个已取消：取取消时间距离当前最近的。

若SIM卡未查询到任何历史套餐信息，则bundle_id为空时，系统返回错误。

版本2023042101

日期：20230421

功能

新增签名计算SDK，参加文档：Quick Start

版本2023041401

日期：20230414

功能

新增API批量获取组织下的SIM卡信息

更新

更新API查询单张SIM卡详细信息

主要更新内容如下
第一级节点：

created（出库时间）暂时去掉

增加status 卡片当前状态: Int（即sim_service.contract.current_lifecycle)

delivery_notice_no 改为delivery_note_no

physical_specs 下的tech移除，放入第一节点，且返回为int枚举

physical_specs

form_factor，返回为int

type 为int

latest_session

latest_session.status 返回Int类型code

session返回数据类型从String改为：Number( Long)

session_start修改为start_at：Number(Long)

session_end修改为end_at: Number(Long)
sim_service

service_type修改为type

contract 下的：

current_lifecycle去掉

contract_start修改为 start_at

testdata 下的：

state改为status

limit、usage返回数据类型从String改为：Number(Long)

global_overage_policy 下的：

pattern 改为type

overage_allowance返回数据类型从String改为：Number(Long)

bundles[] 下的：

data_limit返回数据类型从String改为：Number(Long)

current_cycle_begin改为current_cycle_start_at

current_cycle_end改为current_cycle_end_at

current_cycle_usage返回数据类型改为Number(Long)

created_at改为.added_at

expire_at改为end_at

数据返回增加暂停状态订单

版本 2023033101

日期: 20230331
#: 01

功能

新增API：查询单张SIM卡详情

版本 2023032301

日期: 20230323
#: 01

更新

所有已发布API支持v2签名结构

激活接口升级为异步处理，激活结果基于运营商侧的真实处理结果。且业务规则升级为可在任何状态（废弃除外）下启用一个已经绑定但未启用的套餐。

更新日志

版本 cubeapi-20250102#

版本 cubeapi-20241227#

REST API#

优化#

版本 cubeapi-2024081501#

REST API#

优化#

版本 cubeapi-2024062701#

REST API#

优化#

Notification API#

新增#

版本 cubeapi-2024030701#

REST API#

新增#

版本 cubeapi-2024011801#

Notification API#

优化#

版本 cubeapi-2023121901#

REST API#

新增#

优化#

Notification API#

优化#

版本 cubeapi-2023120701#

REST API#

优化#

版本 cubeapi-2023112401#

REST API#

新增#

优化#

版本 cubeapi-2023110301#

REST API#

新增#

优化#

文档优化#

版本 cubeapi-2023103101#

Notification#

新增#

更新#

API#

更新#

版本 cubeapi-2023102701#

新增#

版本 cubeapi-2023092201#

新增#

更新#

版本2023082501#

更新#

版本2023072001#

新增#

版本2023071301#

新增#

更新#

版本2023061501#

更新#

新增#

版本2023052301#

更新#

版本2023042101#

功能#

版本2023041401#

功能#

更新#

版本 2023033101#

功能#

版本 2023032301#

更新#

版本 cubeapi-20250102

版本 cubeapi-20241227

REST API

优化

版本 cubeapi-2024081501

REST API

优化

版本 cubeapi-2024062701

REST API

优化

Notification API

新增

版本 cubeapi-2024030701

REST API

新增

版本 cubeapi-2024011801

Notification API

优化

版本 cubeapi-2023121901

REST API

新增

优化

Notification API

优化

版本 cubeapi-2023120701

REST API

优化

版本 cubeapi-2023112401

REST API

新增

优化

版本 cubeapi-2023110301

REST API

新增

优化

文档优化

版本 cubeapi-2023103101

Notification

新增

更新

API

更新

版本 cubeapi-2023102701

新增

版本 cubeapi-2023092201

新增

更新

版本2023082501

更新

版本2023072001

新增

版本2023071301

新增

更新

版本2023061501

更新

新增

版本2023052301

更新

版本2023042101

功能

版本2023041401

功能

更新

版本 2023033101

功能

版本 2023032301

更新