平台对接接口详解.docx

文档介绍：文件排版存档编号：[UYTR-OUPT28-KBNTL98-UYNN208]
平台对接接口详解
28181平台对接接口详解
信令接口
平台注册
下级平台主动向上级平台注册；
注册鉴权信息（用户名和密码）由上级提供；
举例说明：
下级--->上级
REGISTERsip:上级平台ID
SIP/
Call-ID:
CSeq:1REGISTER
From:<sip:下级平台ID
To:
Max-Forwards:70
Contact:
Expires:3600
Via:SIP/;branch
Content-Length:0
上级--->下级
SIP/
Via:SIP/;branch
From:
To:
Call-ID:
CSeq:1REGISTER
WWW-Authenticate:Digestrealm="1234",nonce="7104983f5477dd30a65167b28553df65",algorithm=MD5
User-Agent:Hikvision
Expires:3600
Content-Length:0
下级--->上级
REGISTERSIP/
Call-ID:
CSeq:2REGISTER
From:
To:
Max-Forwards:70
Contact:
Via:SIP/;branch
Authorization:Digestusername="admin"上级平台提供鉴权信息时指定的用户。
,realmresponse="下级平台根据上级平台返回的挑战字和上级平台的鉴权信息，用MD5算法计算得到。
Expires:3600
Content-Length:0
上级--->下级
SIP/
Via:SIP/;branch
From:
To:
Call-ID:
CSeq:2REGISTER
Contact:
User-Agent:Hikvision
Date:2013-07-27T14:45:39
Content-Length:0
平台心跳保活
下级平台定期向上级平台发心跳消息；
定期时间可配置，上下级配置一致；
上级平台连续三次未收到下级心跳消息，则认为下级平台离线；
下级平台连续三次未收到心跳响应，则认为上级平台离线；
举例说明：
下级--->上级
MESSAGESIP/
Call-ID:
CSeq:1MESSAGE
From:
To:
Max-Forwards:70
Content-Type:application/Xml
Via:SIP/;branch
Content-Length:138
<xmlversion="">
<Notify>
<CmdType>Keepalive</CmdType>
<SN>43</SN>
<DeviceID>下级平台ID
</DeviceID>
<Status>OK</Status>
</Notify>
上级--->下级
SIP/
Via:SIP/;branch
From:
To:
Call-ID:
CSeq:1MESSAGE
Content-Length:0
平台设备共享
下级平台将设备共享给上级平台，共享关系临时保存在本地数据库；
下级平台收到上级平台的目录查询消息时，返回共享给该上级平台的所有共享设备信息；
上级平台收到目录查询响应结果后，根据设备编码或自定义方式给设备建立目录；
上级平台最好支持定期查询目录和手动查询目录功能，以便及时获取到下级平台新共享的设备；
举例说明
上级--->下级上级向下级发送目录查询请求
MESSAGESIP/
Via:SIP/;rport
From:
To:
Call-ID:
CSeq:20MESSAGE
Content-Type:Application/MANSCDP+xml
Max-Forwards:70
User-Agent:Hikvision
Content-Length:127
<xmlversion="">
<Query>
<CmdType>Catalog</CmdType>
<SN>8903查询消息的序号，下级平台返回的查询响应消息的序号必须和该序号一致，以便标识是该查询的响应。
</SN>
<DeviceID>下级平台ID
（上级平台查询下级平台共享设备）
</DeviceID>