SIM卡暂停

将废弃

Cube Prod

PUT

https://api.linksfield.net/cube/v4/sims/{sim_id}/suspend

简要描述

版本：

4.0.0

适用场景：

适用于企业希望可以自主控制将SIM卡服务暂停，并预设服务恢复时间。
若再到达付费恢复时间前，需要提前恢复卡片服务，请使用API***SIM卡激活***立即恢复服务。

业务说明：

暂停成功后，系统将按暂停前的剩余周数订购一个新的套餐订单。若暂停时剩余周期不足一共套餐的完整周期，则暂停成功后不会订购新的套餐。
暂时时间可以为当日，暂停后立即生效。预设自动激活时间最早为暂停次日，且再当日的0点左右自动恢复。

必要条件：

SIM卡不支持OTA功能

SIM卡当前使用中套餐类型为月套餐

SIM卡的生命周期处于使用期

通过设备IMEI或SN查询绑定的SIM卡ICCID请使用API查询SIM卡信息

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v1().service().suspendAsync(new SuspendAsync(5, "89852202500930228848"));
client.v2().service().suspendAsync(new SuspendAsync(5, "89852202500930228848"));

请求参数

Path 参数

sim_id

string

必需

Query 参数

suspend_date

string

必需

卡片服务暂停计划开始日期，当日起30天（含）的任意日期，传当日代表立即暂停。

activate_date

string

必需

卡片服务暂停计划结束并恢复日期，距离暂停开始不能超过365天（含）,最早日期为明日

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Authorization

string

必需

LF {lfAccessKeyId}/{sign} 必填项

默认值:

X-LF-Api-Version

string

可选

默认值: 此最新版本。如最新版本为2.0，则默认1.0

X-LF-Signature-Type

string

1.0、2.0

可选

timestamp

string

必需

毫秒时间戳；只接受10分钟之内请求

nonce

integer

必需

随机正整数，取值范围：0-2147483647

Body 参数application/json

timestamp

string

必需

nonce

integer

可选

示例

{
  "timestamp": "1640749507",
  "nonce": 66
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.linksfield.net/cube/v4/sims//suspend?suspend_date=&activate_date=' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization;' \
--header 'X-LF-Api-Version;' \
--header 'X-LF-Signature-Type;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "timestamp": "1640749507",
    "nonce": 66
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2023-04-21 09:28:27

查询SIM卡指定套餐某时间段的流量使用量

查询SIM卡当前使用订单累计流量

SIM卡暂停

简要描述#

版本：#

适用场景：#

业务说明：#

必要条件：#

SDK API 调用方式#

请求参数

示例代码

返回响应

简要描述

版本：

适用场景：

业务说明：

必要条件：

SDK API 调用方式