新增设备

使用该接口在设备管理中新增一台设备。新增设备的类型为管理员导入

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/security_and_compliance/v2/device_records
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	security_and_compliance:device_record:write 新增、更新、删除设备

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
device_system	int	是	操作系统 示例值：0 可选值有： - 1: Windows - 2: macOS - 3: Linux - 4: Android - 5: iOS - 6: OpenHarmony
serial_number	string	否	生产序列号 示例值："C02DTHRMML7H"
disk_serial_number	string	否	硬盘序列号 示例值："CC344362-5990-5A68-8DDD-64A23C99FA0C"
uuid	string	否	主板UUID 示例值："621CDFF0-13D0-5AB1-9ADC-5F560095F6ED"
mac_address	string	否	MAC地址 示例值："ac🇩🇪48:00:11:21"
android_id	string	否	Android标识符 示例值："02a11ac4a83b918e"
idfv	string	否	iOS供应商标识符 示例值："968F0E5C-C297-4122-ACB6-102494DEFD9A"
aaid	string	否	Harmony供应商标识符 示例值："ff3c2237-cd76-4331-9d72-0a4470854567"
device_ownership	int	是	设备归属 示例值：0 可选值有： - 0: 未知设备 - 1: 个人设备 - 2: 企业设备
device_status	int	是	可信状态 示例值：0 可选值有： - 0: 未知状态 - 1: 信任设备 - 2: 非信任设备

请求体示例

// Windows / macOS / Linux
{
    "device_system": 1 / 2 / 3,
    "serial_number": "C02DTHRMML7H",
    "disk_serial_number": "CC344362-5990-5A68-8DDD-64A23C99FA0C",
    "uuid": "621CDFF0-13D0-5AB1-9ADC-5F560095F6ED",
    "device_ownership": 0,
    "device_status": 0
}

// Android
{
    "device_system": 4,
    "android_id": "02a11ac4a83b918e",
    "device_ownership": 0,
    "device_status": 0
}

// iOS
{
    "device_system": 5,
    "idfv": "968F0E5C-C297-4122-ACB6-102494DEFD9A",
    "device_ownership": 0,
    "device_status": 0
}

// OpenHarmony
{
    "device_system": 6,
    "aaid": "ff3c2237-cd76-4331-9d72-0a4470854567",
    "device_ownership": 0,
    "device_status": 0
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ device_record_id	string	设备认证编码

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "device_record_id": "7089353870308032531"
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1780001	Internal server error.	内部接口处理失败。若无法解决请寻求客服帮助
400	1780101	Request param error.	检查参数是否正确
400	1780102	The API is in beta testing. Please contact customer support to request beta access.	联系服务提供方排查
400	1785005	The device information corresponding to the operating system is invalid. Please check the device information in the request.	检查参数中设备特征是否与操作系统匹配
400	1785007	The parameter device_system is invalid.	检查参数中操作系统字段是否正确
400	1785010	The device already exists.	系统中符合该设备特征的设备已存在