附件五多形态终端上报接口v1.0

1、多形态终端上报接口规范作者：日期： 2018-03-16审核：日期：批准：日期：（，）文件受控版次vs1.0.8密级总页数附录1接口总体概述协议概述定义多形态终端与 DMP 服务端通信规范。接口采用基于 COAP 协议的 LwM2M 协议进行通信。UE 按照协议规范将需要上报的数据进行封装，通过COAP 地址与 DMP 服务端进行上报通信，DMP 进行响应上报结果进行回执。1.-register是 UE 在使用 DMP 时,向 DMP 发起的流程，主要用于 UE 首次向设备自身能力和 DMP 通讯以及设备离线后再次和服务器握手根据 LwM2m 规范目前信息封装进 endpo字段，拼接规则如下：

2、endpo中包含终端类型、CMEI/IMEI1、IMEI2、IMSI、DM 版本号、appkey 6 个信息，（上报时间和 IP 地址由服务器获取），终端类型简称参见附件 2，以”#”拼接后面信息，CMEI/IMEI1、IMEI2、IMSI、DM 版本号这 4 条信息以”-”进行拼接，然后进行加密，若其中某条信息为空则以”*”代替这条信息，最后再用”#”拼接 appkey。例：A#imei1-imei2-imsi-v1.0#appkey123456*注意* imei1-imei2-imsi-v1.0 这 4 条信息加密后再和终端类型、appkey 用#拼接（加密）上报的信息除了终端类型和 ap

3、pkey 之外需进行 AES 加密，加密模式为(),先 SHA256 摘要，再 AES 加密，最后 BASE64编码。秘钥和 appkey 通过邮件向技术部申请DMP 接受到数据后，将按 LwM2m 规范封装 LwM2mResponse 进行回执。例：成功 ResponseCode.CREATED （201）AES/CBC/PKCS7Padding2. 更新-updateUE 向 DMP 发起 update-register，DMP 接收到上报数据进行保存并回执更新成功信息update-response。根据 LwM2m 规范已有信息的终端设备，保存有 registionId 的设备上报终端类

4、型、CMEI/IMEI1、IMEI2、IMSI、verify、appkey 6 条信息。根据LwM2m 规范目前信息封装进endpoinfo()字段，拼接规则如下：endpoinfo 中包含终端类型、信息，（上报时间和 ip 由服务器获取系统时间，verify 为校验字段），终端类型简称参见附件 2，以”#”拼接后面的 4 条信息，以”-”进行拼接，然后进行加密，若其中某条信息为空则以”*”代替这条信息，加密后再用#拼接 appkey，例如 verify 字段为安卓需要上报的信息，其它无此信息就以”*”代替，详见附件 3。例：A#imei1-imei2-imsi-verify#appkey12

5、3456*注意* imei1-imei2-imsi-verify 这 4 条信息加密后再和终端类型、appkey用#拼接（加密）上报信息需进行 AES 加密，加密模式为(),先 SHA256 摘要，再 AES 加密，最后 BASE64 编码。秘钥和 appkey 通过邮件向技术部申请DMP 接受到数据后，将按 LwM2m 规范封装 LwM2mResponse 进行回执。例：成功 ResponseCode.CHANGED （204）上报地址：co:5683(1)适配上报地址:coap:/s:5683()适配信息管理:https:/s/附件 1-返回码对照表AES/CBC/PKCS7Padding

6、这 4 条信息CMEI/IMEI1、IMEI2、IMSI、verifyCMEI/IMEI1、IMEI2、IMSI、verify、appkey 6 条附件 2-终端类型简称对照表附件 3-各上报字段总览：（非必选字段为空仍以“*”作为默认值上报，需要加密的字段以“-”拼接例如：单独模组上报的，imei1 上报为*，imei2 上报模组的 imei。）字段说明安卓Linux接口是否加密Terminaltyp e终端类型 A、L、 I必选必选必选否Imei1终端 Imei必选必选必选是Imei2模组 Imei非必选非必选非必选是imsiimsi必选必选必选是终端类型简称安卓ALinuxL接口I返回码对应说明201成功202注销成功204更新成功205订阅成功400请求失败403请求404资源失败心跳：（非必选字段为空仍以“*”作为默认值上报，需要加密的字段以“-”拼接例如：单独模组上报的，imei1 上报为*，imei2 上报模组的 imei。）android 终端技术支持号技术支持号linux 终端技术支持号字段说明安卓Linux接口是否加密Terminaltyp e终端类型 A、L、 I必选必选必选否Imei1终端 Imei必选必选必选是Imei2模组 I