bmtcloud

绑定设备

POST

/api/device/v1/create

请求参数

Header 参数

string

必需

默认值:

timestamp

integer

必需

默认值:

{% mock 'timestamp' , 's' %}

sign

string

必需

默认值:

{% mock 'string' , 'lower' , 32 , 32 %}

Body 参数application/json

biz_type

integer

必需

A:1,B:3,M:9,Z:2

device_id

string

设备ID

必需

remark

string

备注

必需

isp

string

运营商

必需

province

string

省份

必需

city

string

城市

必需

up_bandwidth

integer

必需

上行带宽(Mbps)

line_number

integer

线路数量

必需

dialing_type

string

必需

拨号类型:
[PPPOE(服务器拨号),1VN(路由器),PUBLIC_MULTI_IP(固定公网IP),PUBLIC_SINGLE_IP（固定公网单IP）]

示例值:

PPPOE

nat_type

string

必需

NAT类型: [inner(内网),public(公网)]

示例值:

inner

ip_protocol

string

必需

协议栈: [双栈,IPv4,IPv6]

plan_task

string

可选

目标业务 [可选值见业务列表接口]，用于Z业务

province_ratio

integer

可选

跨省调度比例（0-100），大于0表示可跨省。用于M、Z业务

is_night_peak

boolean

可选

是否仅跑晚高峰（20:00-23:00），用于Z业务

示例

{
    "biz_type": 0,
    "device_id": "string",
    "remark": "string",
    "isp": "string",
    "province": "string",
    "city": "string",
    "up_bandwidth": 0,
    "line_number": 0,
    "dialing_type": "PPPOE",
    "nat_type": "inner",
    "ip_protocol": "string",
    "plan_task": "string",
    "province_ratio": 0,
    "is_night_peak": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.bmtcloud.com.cn/api/device/v1/create' \
--header 'ak;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "biz_type": 0,
    "device_id": "string",
    "remark": "string",
    "isp": "string",
    "province": "string",
    "city": "string",
    "up_bandwidth": 0,
    "line_number": 0,
    "dialing_type": "PPPOE",
    "nat_type": "inner",
    "ip_protocol": "string",
    "plan_task": "string",
    "province_ratio": 0,
    "is_night_peak": true
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

current_time

integer

必需

event_id

string

必需

示例

{
    "code": 0,
    "message": "success",
    "current_time": 1676795641,
    "event_id": "20230219163401773009100000004787",
    "data": {}
}

🟢200公共响应