附件五多形態(tài)終端上報接口v1.0

1、多形態(tài)終端上報接口規(guī)范作者：日期： 2018-03-16審核：日期：批準：日期：（，）文件受控版次vs1.0.8密級總頁數(shù)附錄1接口總體概述協(xié)議概述定義多形態(tài)終端與 DMP 服務端通信規(guī)范。接口采用基于 COAP 協(xié)議的 LwM2M 協(xié)議進行通信。UE 按照協(xié)議規(guī)范將需要上報的數(shù)據(jù)進行封裝，通過COAP 地址與 DMP 服務端進行上報通信，DMP 進行響應上報結(jié)果進行回執(zhí)。1.-register是 UE 在使用 DMP 時,向 DMP 發(fā)起的流程，主要用于 UE 首次向設備自身能力和 DMP 通訊以及設備離線后再次和服務器握手根據(jù) LwM2m 規(guī)范目前信息封裝進 endpo字段，拼接規(guī)則如下：

2、endpo中包含終端類型、CMEI/IMEI1、IMEI2、IMSI、DM 版本號、appkey 6 個信息，（上報時間和 IP 地址由服務器獲?。K端類型簡稱參見附件 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 接受到數(shù)據(jù)后，將按 LwM2m 規(guī)范封裝 LwM2mResponse 進行回執(zhí)。例：成功 ResponseCode.CREATED （201）AES/CBC/PKCS7Padding2. 更新-updateUE 向 DMP 發(fā)起 update-register，DMP 接收到上報數(shù)據(jù)進行保存并回執(zhí)更新成功信息update-response。根據(jù) LwM2m 規(guī)范已有信息的終端設備，保存有 registionId 的設備上報終端類

4、型、CMEI/IMEI1、IMEI2、IMSI、verify、appkey 6 條信息。根據(jù)LwM2m 規(guī)范目前信息封裝進endpoinfo()字段，拼接規(guī)則如下：endpoinfo 中包含終端類型、信息，（上報時間和 ip 由服務器獲取系統(tǒng)時間，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 接受到數(shù)據(jù)后，將按 LwM2m 規(guī)范封裝 LwM2mResponse 進行回執(zhí)。例：成功 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