单卡/设备订购套餐包 - V2.0开放接口

请求参数

Header 参数

appID

string

必需

默认值:

1

apiVersion

string

必需

默认值:

2.0.0

traceID

string

必需

默认值:

5831f960804c9217ec01e425b8cc76f5

timestamp

string

必需

默认值:

1703592981

sign

string

必需

默认值:

65987d12ae39b2c449b495c77c83c8ef

Body 参数application/x-www-form-urlencoded

simNo

string

必需

卡板卡号，设备充值时请传入主卡卡板卡号

示例值:

1929033251

packageId

string

必需

套餐包编码，在套餐包列表中查看

示例值:

22

effectType

string

必需

生效时间 1立即生效，2次月生效

示例值:

1

customNo

string

必需

自定义订单号，对接方的唯一订单号(8-64位数字字母)

示例值:

de7924190818450ae817cbb2e1ce

remark

string

订单备注

必需

示例值:

接口备注

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://127.0.0.1:2000/openapi/iot/submitPackageOrder' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'simNo=1929033251' \
--data-urlencode 'packageId=22' \
--data-urlencode 'effectType=1' \
--data-urlencode 'customNo=de7924190818450ae817cbb2e1ce' \
--data-urlencode 'remark=接口备注'

返回响应

🟢200成功

application/json

Body

0成功，其他失败

code

integer

必需

message

string

必需

data

object

必需

packageId

integer

订购套餐包编码

必需

packageName

string

套餐包名称

必需

packageType

integer

套餐包类型

必需

totalFlow

integer

套餐总流量(KB)

必需

useFlow

integer

必需

套餐已用流量(KB)

effectiveStatus

integer

必需

套餐生效状态，请参考物联卡相关状态码说明

effectiveCycle

integer

必需

套餐生效周期，请参考物联卡相关状态码说明

startAt

string

开始时间

必需

endAt

string

结束时间

必需

orderSn

string

我方订单号

必需

actualPayMoney

integer

订单实付金额

必需

customNo

string

必需

对接方提供的自定义订单号

remark

string

订购备注

必需

timestamp

integer

必需

traceID

string

必需

示例

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "packageId": 22,
    "packageName": "测试1G叠加包",
    "packageType": 3,
    "totalFlow": 1048576,
    "useFlow": 0,
    "effectiveStatus": 1,
    "effectiveCycle": 1,
    "startAt": "2024-11-01 00:00:00",
    "endAt": "2024-12-01 00:00:00",
    "orderSn": "SP20241115182300zJOX",
    "actualPayMoney": 5,
    "customNo": "de7924190818450ae817cbb2e1ce",
    "remark": "接口备注"
  },
  "timestamp": 1731666181,
  "traceID": "5831f960804c9217ec01e425b8cc76f5"
}