文档首页 > > API参考> API> RESTFUL接口> 添加一个车辆 AddVehicle

添加一个车辆 AddVehicle

分享
更新时间:2020/04/27 GMT+08:00

功能介绍

车企/TSP平台向车联网服务同步车辆,新增一个Vehicle资源。

URI

POST BaseUrl/v1/{project_id}/ociov/{ociov_id}/vehicles

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

project_id 项目编号

ociov_id

String

ociov_id 开通公有云账户申请资源后获取的资源编号

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

vehicle_model_id

String

车型ID。

vehicle_model

String

车型。

vin

String

车架号。

sim

SIMDTO

车辆设备SIM卡配置

tbox

TBoxDTO

车辆T-BoX信息

ivi

IVIDTO

车辆IVI信息

description

String

车描述。

表3 SIMDTO

参数

是否必选

参数类型

描述

imsi

String

国际移动用户识别码。

msisdn

String

移动用户号码。

iccid

String

集成电路卡识别码。

euiccid

String

eSIM卡标识。

表4 TBoxDTO

参数

是否必选

参数类型

描述

device_id

String

设备ID。

imei

String

国际移动设备标志。

cname

String

设备接入证书的Common Name。

表5 IVIDTO

参数

是否必选

参数类型

描述

device_id

String

设备ID。

响应参数

状态码为 201 时:

表6 响应Body参数

参数

参数类型

描述

project_id

String

项目ID。

ociov_id

String

车联网服务的ID。

vehicle_id

String

车ID。

vehicle_model_id

String

车型ID。

vehicle_model

String

车型。

vin

String

车架号。

description

String

车描述。

status

String

车连接状态。

取值范围:

  • OFFLINE

  • ONLINE

sim

SIMDTO

-

tbox

TBoxDTO

-

ivi

IVIDTO

-

etag

Integer

首次置1,以后每次修改加1。

tenantId

String

租户ID。

tenantName

String

租户名称。

create_time

String

创建时间。

last_modified_time

String

最后修改时间。

表7 SIMDTO

参数

参数类型

描述

imsi

String

国际移动用户识别码。

msisdn

String

移动用户号码。

iccid

String

集成电路卡识别码。

euiccid

String

eSIM卡标识。

表8 TBoxDTO

参数

参数类型

描述

device_id

String

设备ID。

imei

String

国际移动设备标志。

cname

String

设备接入证书的Common Name。

表9 IVIDTO

参数

参数类型

描述

device_id

String

设备ID。

状态码为 403 时:

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

{
"vehicle_model_id" : "1234567890",
"vehicle_model" : "1234567890",
"vin" : "1234567890",
"sim" : {
	"imsi" : "1234567890",
	"msisdn" : "1234567890",
	"iccid" : "1234567890",
	"euiccid" : "1234567890"
},
"tbox" : {
	"device_id" : "1234567890",
	"imei" : "1234567890",
	"cname" : "1234567890"
},
"ivi" :"string" ,
"description" : "Wonderful Vehicle"
}

响应示例

状态码为 201 时:

{
"project_id" : "1234567890",
"ociov_id" : "1234567890",
"vehicle_id" : "1234567890",
"vehicle_model_id" : "1234567890",
"vehicle_model" : "1234567890",
"vin" : "1234567890",
"description" : "Wonderful Vehicle",
"status" : "OFFLINE",
"sim" : {
	"imsi" : "1234567890",
	"msisdn" : "1234567890",
	"iccid" : "1234567890",
	"euiccid" : "1234567890"
},
"tbox" : {
	"device_id" : "1234567890",
	"imei" : "1234567890",
	"cname" : "1234567890"
},
"ivi" :"string" ,
"etag" : 1,
"tenantId" : "1234567890",
"tenantName" : "1234567890"
}

状态码为 403 时:

"error_code" : "VehicleOC.000101",
"error_msg" : "Resource limit reached.",

状态码

状态码

描述

201

Created

403

Forbidden

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问