To ensure normal voice calls, HTTP API requires you to perform security authorization in accordance with the security rules described in this section, otherwise the device will reject your HTTP request.

Currently, it only supports HTTPS (not HTTP) to execute HTTP API. HTTP may bring you a security risk of leaking sensitive information (such as user name, password), so be sure to use https.

3.0.1 Voice intercom adding

Explanation

There are 2 situations:

1. If the user calls this API to implement voice intercom, call it directly and use https.

2. If the device calls this API to implement voice intercom, it only supports http mode and the port is 81.

Before you use any of the HTTP API mentioned in this document, you must obtain authorization.

The authorization mechanism of the voice intercom server is as follows:

1) Add in the Cookie of Request Headers, for example:

time=undefined; username=admin; user=admin; alias=admin; token=ZIK48H80V32Y17R0IBZA8F4P3AGCGF2F；

The username, user and token must be added.

Authorization itself is also an HTTP API, but it is different from other API in that Authorization Token is not authorization, but to authorize Authorization Token by checking the user name and password you submitted.

---

Device to web

API URL

​ /intercom/talkback/talk_add.json

Request

​ Method：GET/POST

Field	Value	Description
ip	[STRING] ,Required	Server IP

Device to device

API URL

​ /intercom/talkback/talk_add.json

Request

​ Method：GET/POST

Field	Value	Description
username	[STRING] ,Required	The name of the device, it is the serial number now.
ip	[STRING] ,Required	Server IP
token	[STRING] ,Required	Device serial number

Response

Format（Example）：

{
    "result":"ok",
    "data":{
        "sdp":"v=0\r\no=- 1495799811084970 1495799811084970 IN IP4 192.168.2.112\r\ns=-\r\nt=0 0\r\na=group:BUNDLE audio\r\na=msid-semantic: WMS \r\nm=audio 1 RTP\/SAVPF 0\r\nc=IN IP4 0.0.0.0\r\na=mid:audio\r\na=sendrecv\r\na=rtcp-mux\r\na=ice-ufrag:h3ir\r\na=ice-pwd:090ssf9ozpisukrcdq1l58ap\r\na=ice-options:trickle\r\na=fingerprint:sha-256 43:0C:E5:B9:29:CA:3B:E2:E5:C9:36:44:3A:80:E8:C5:1F:F4:27:4F:12:00:47:4C:F7:83:77:E2:69:FA:77:77\r\na=setup:actpass\r\na=rtpmap:0 PCMU\/8000\/1\r\na=candidate:1 1 udp 12345678 192.168.2.112 59169 typ host\r\n",
        "id":59169
    }
}

Data field description：

Field	Value	Description
sdp	[STRING]	sdp information
id	[INT]	Port

Note:

The server will automatically release users and devices connected.

---