Black Box BDS-8W Instruction sheet

24/7 TECHNICAL SUPPORT AT 1.877.877.2269 OR VISIT BLACKBOX.COM
BDS-8W, BDS-8THA, BDS-8FHA
BDS CLOUD SERVER CONFIGURATION MANUAL
BDS CLOUD
SERVER
CONFIG

2
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877.2269
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
TABLE OF CONTENTS
CONTENTS
1. DYNAMIC DETECTION DISPLAY CALLBACK INTERFACE V1.1 ............................................................................................................ 4
2. DYNAMIC DETECTION DISPLAY LAN INTERFACE V1.4........................................................................................................................ 6
2.1 INTERFACE SPECIFICATION.................................................................................................................................................................... 6
2.2 SET DEVICE PASSWORD .......................................................................................................................................................................... 6
2.3 PARAMETER CONFIGURATION (FACE RECOGNITION, OPENING MODE, ETC.)............................................................................. 7
2.4 GET PARAMETER CONFIGURATION (FACE RECOGNITION, SWITCHING MODE, ETC.) ................................................................ 9
2.5 PERSONNEL REGISTRATION................................................................................................................................................................. 10
2.6 PERSONNEL INFORMATION EDITING.................................................................................................................................................. 11
2.7 DELETE PERSON...................................................................................................................................................................................... 12
2.8 IDENTIFICATION RECORD ACQUISITION............................................................................................................................................ 13
2.9 MODIFY LOGO .......................................................................................................................................................................................... 14
2.10 ACQUISITION OF EQUIPMENT MAC ADDRESS ................................................................................................................................ 15
2.11 PARAMETER CONFIGURATION (BODY TEMPERATURE, MASK, FAN, ETC.)................................................................................ 15
2.12 ACCESS TO PHOTOS ............................................................................................................................................................................. 17
2.13 DEVICE PARAMETER INFORMATION ACQUISITION....................................................................................................................... 18
2.14 TAKING PICTURES................................................................................................................................................................................. 18
2.15 DEVICE INITIALIZATION....................................................................................................................................................................... 19
2.16 SYSTEM TIME SETTING ....................................................................................................................................................................... 19
2.17 IDENTIFY THE RECORDING INTERFACE CALLBACK SETTINGS................................................................................................... 20
2.18 DEVICE DOOR CONTROL ...................................................................................................................................................................... 20
2.19 GET BODY TEMPERATURE AND MASK PARAMETERS ................................................................................................................... 21
2.20 PERSONNEL CHECKUP ........................................................................................................................................................................ 22
2.21 PERSONNEL PAGE QUERY................................................................................................................................................................... 23
3. DYNAMIC DETECTION DISPLAY COMMUNICATION PROTOCOL USAGE........................................................................................ 25
3.1 PROTOCOL DESCRIPTION...................................................................................................................................................................... 25
3.1.1 INTERFACE SPECIFICATION ...........................................................................................................................................................................25
3.1.2 PROTOCOL FIELD DESCRIPTION ..................................................................................................................................................................25
3.1.3 PROTOCOL REPLY INSTRUCTIONS ..............................................................................................................................................................25
3.2 PROTOCOL LIST....................................................................................................................................................................................... 26
3.2.1 DEVICE REGISTRATION...................................................................................................................................................................................26
3.2.2 HEARTBEAT........................................................................................................................................................................................................26
3.2.3 PARAMETER CONFIGURATION.................................................................................................................................................................... 27
3.2.4 PERSONNEL REGISTRATION........................................................................................................................................................................ 29
3.2.5 PERSONNEL INFORMATION EDITING........................................................................................................................................................ 30
3.2.6 DELETE PERSONNEL........................................................................................................................................................................................31
3.2.7 IDENTIFICATION RECORD UPLOAD ADDRESS SETTING .......................................................................................................................31
3.2.8 MODIFY LOGO................................................................................................................................................................................................... 32
3.2.9 BODY TEMPERATURE AND MASK PARAMETER CONFIGURATION................................................................................................... 32
3.2.10 DEVICE INITIALIZATION............................................................................................................................................................................... 33
3.2.11 VERSION UPGRADE ....................................................................................................................................................................................... 33

3
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
TABLE OF CONTENTS
3.2.12 REMOTE DOOR OPENING............................................................................................................................................................................. 34
3.2.13 REMOTE RESTART ......................................................................................................................................................................................... 34
3.2.14 TEST RESULTS OF PERSONNEL PHOTOS ............................................................................................................................................... 34
3.2.15 INQUIRY OF PERSONNEL INFORMATION................................................................................................................................................ 36
3.2.16 QUERY PERSONNEL INFORMATION RESULTS....................................................................................................................................... 36
3.2.17 QUERY PERSONNEL INFORMATION ......................................................................................................................................................... 37
3.2.18 PAGINATION QUERY RESULTS OF PERSONNEL INFORMATION....................................................................................................... 38
3.2.19 PARAMETER CONFIGURATION QUERY.................................................................................................................................................... 39
3.2.20 PARAMETER CONFIGURATION QUERY RESULTS ................................................................................................................................ 39
3.2.21 BODY TEMPERATURE PARAMETER CONFIGURATION QUERY ........................................................................................................ 40
3.2.22 QUERY RESULTS OF BODY TEMPERATURE PARAMETER CONFIGURATION................................................................................ 40
3.2.23 SHUTDOWN..................................................................................................................................................................................................... 40
3.2.24 APPLICATION GUARD....................................................................................................................................................................................41
3.2.25 POWER ON ........................................................................................................................................................................................................41
DISCLAIMER.................................................................................................................................................................................... 42
TRADEMARKS USED IN THIS MANUAL........................................................................................................................................ 42

41. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 1: DYNAMIC DETECTION DISP. CALLBACK INT. V1.1
1. DYNAMIC DETECTION DISPLAY CALLBACK INTERFACE V1.1
Instructions: This interface is a description of the interface that the client APP pushes to other backgrounds. We recommend that you
first use postman and other tools to test and verify.
After the interface development is completed, you can set it in the APP application settings, then enter the callback address to save and
use.
INTERFACE SPECIFICATION
Interface uploadMipsGateRecord
address url address
mode POST
required parameter JSON
return type JSON
FACE DETECTION RESULT DATA PUSH INTERFACE
REQUIRED PARAMETER PARAMETER PARAMETER MODE REQUEST OR NOT EXPLANATION
device ID mac string YMAC address format, 12 bits
userId userId string YPerson ID, -1 means stranger
checkTime checkTime long Y Timestamp
name name string N Personnel name
type type int N
Identity type, 1 is visitor, 2 is
blacklist, 3 for employees, 4 for ID
card identification

5
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 1: DYNAMIC DETECTION DISP. CALLBACK INT. V1.1
FACE DETECTION RESULT DATA PUSH INTERFACE (CONTINUED)
REQUIRED PARAMETER PARAMETER PARAMETER MODE REQUEST OR NOT EXPLANATION
cardNo cardNo string NCard number information, stranger is empty
idCardNo idCardNo string NID card number
temperature temperature string N temperature, e.g., 36.5
mask mask int N mask, 1-wear, 0-no wear
Pic infos checkPic string NSnap pictures, the picture format is Base64
extra extra string NExtra information, extended use
ID card information sex String N
ID CARD INFO nation String N
ID CARD INFO: birthdate birthdate String N
ID CARD INFO: address address String N
ID CARD INFO: photo cardPhoto String NFrom base64
RETURN VALUE
REQUIRED PARAMETER PARAMETER EXPLANATION
Return result code 0-success, 1-fail
Return information msg Return information
Example:
{
“mac”: “8CFCA0039257”,
“userId”: “”,
“checkTime”: 1585361367292,
“name”: “test”,
“type”: -1,
“cardNo”: “”,
“idCardNo”: “440...”,
“temperature”: “36.6”,
“mask”: -1,
“checkPic”: “”,
“extra”: “”,
“sex”: “”,
“nation”: “”,
“birthdate”: “1986-9-2”,
“address”: “...”,
“cardPhoto”: “”
}return example
{
“code”: 0,
“msg”: “Push successfully”
}

61. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
2. DYNAMIC DETECTION DISPLAY LAN INTERFACE V1.4
2.1 INTERFACE SPECIFICATION
Interface root address: http://device ip address: 8080/
Interface form: provide external services through HTTP requests
Interface security: The device password (pass) needs to be set first when calling.
The interface for the first time, and the device password (pass) needs to be passed in as the interface security verification key for any
subsequent calls to the interface.
Interface returns
Interface general return instructions:
public class ResultInfo <T> {
private Int result; // Indicates whether the interface is tuned up, 1: succeeds, 0: fails, usually as long as the device server can respond, the
value is 1
private Boolean success; // Whether the operation is successful, the success is true, the failure is false private T data; // The business
data returned by the interface, the type can be numeric, string or collection, etc
Interface list
2.2 SET DEVICE PASSWORD
Request method: POST request
Request address: http://device IP:8080/setPassWord
DATE
FIELD DATE REQUEST DESCRIPTION
oldPass ID String YOld password
newPass String YNew password
Request description: For new devices or devices after resetting (restoring initialization), you need to set the initial password before calling
other interfaces. OldPass and newPass can be passed the same value. When changing the password, paste in the new and old password
separately.
Example:
{
“data”: “passWord:q”, // The device password, also called the interface calling password, please enter it properly. If you forget your
password, you need to reset the device, and the device will erase all data.
“result”: 1,// Interface tuning
“success”: true// Device password set successfully
}

7
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
2.3 PARAMETER CONFIGURATION (FACE RECOGNITION, OPENING MODE, ETC.)
Request method: POST request
Request address: http://device IP: 8080/setConfig
DATE
FIELD MODE REQUEST DESCRIPTION
pass String YPassword setting
config Json YParameter configuration Json The following are the parameters of json
Request description
POST request parameters are placed in the body
The config request parameter is in json format, an example follows (adjust according to the actual situation).
{
“companyName”: “smdt”,
“deviceId”: 86,
“displayCustom”: “{name}”,
“displayMode”: 1,
“id”: 1,
“liveIdentiLevel”: 1,
“passType”: false,
“password”: “123456”,
“recoDistance”: “1.5”,
“recoInterval”: “2000”,
“relayDelay”: 5,
“relayMode”: 0,
“serialCustomize”: “#{idcardNum}#”,
“serialMode”: 2,
“similarity”: 80,
“strangerVoiceCustom”: “moshengren”,
“strangerVoiceMode”: 2,
“voiceCustom”: “name”,
“voiceMode”: 1,
“wg”: 0
}

81. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
FIELD
FIELD MODE DESCRIPTION
companyName String companyName
deviceId int deviceId
displayCustom String displayCustom default as {name}
displayMode int displayMode, 1: name, 100: custom
id int
liveIdentiLevel int Living body recognition level, default fast mode, 0 no living body, 1 fast mode cannot reject photos, 2
can reject some photos, 3 can reject photos and adapt
passType boolean Access type false into true out
password String passcode
recoDistance String Recognition distance (0.5–3)
recoInterval String Recognition interval 2000–10000
relayDelay Int Relay automatically closes after a delay of x seconds (5–63)
Relay mode Int
relayMode
0: indicates the automatic closing mode, that is, X seconds will be delayed after the relay is opened.
Dynamic closure
1: It means that it does not close automatically, that is, it will not close automatically after opening the
relay.
Fit
serialCustomize String Serial port definition, default is “#{idcardNum}#”, Unlimited length
similarity Int Similarity, default 80, 30–100 adjustment
strangerVoiceCustom String Stranger voice customization, default for stranger recognition, within 32 characters
strangerVoiceMode Int Stranger voice mode, the default stranger alarm, 1 does not require voice broadcast, 2 Stranger
alarm, 100 custom
voiceCustom String Voice customization, default is “name”, within 32 characters
voiceMode Int Voice mode, 1 no broadcast, 2 broadcast name, 100 custom
wg Int Wiegand 26 or 34 output mode, 0: output card number WG26, 1: output person
Staff ID WG26,2: output card number WG34, 3: output staff ID WG34
icNO int IC Card,
1: Card Swipe
idCardNo int ID Card
1: Close
tricolorLamp int Red light, 1: Off, 2: On

9
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Return data
{
“data”: { // Set parameters
“companyName”: “smdt”,
“deviceId”: 86,
“displayCustom”: “{name}”,
“displayMode”: 1,
“id”: 1,
“liveIdentiLevel”: 1,
“passType”: false,
“password”: “123456”,
“recoDistance”: “1.5”,
“recoInterval”: “2000”,
“relayDelay”: 5,
“relayMode”: 0,
“serialCustomize”: “#{idcardNum}#”,
“serialMode”: 2,
“similarity”: 80,
“strangerVoiceCustom”: “moshengren”,
“strangerVoiceMode”: 2,
“voiceCustom”: “name”,
“voiceMode”: 1,
“wg”: 0
},
“result”: 1, // Interface access
“success”: true // Setting successful
}
2.4 GET PARAMETER CONFIGURATION (FACE RECOGNITION, SWITCHING MODE, ETC.)
Request method: POST request
Request address: http://device IP:8080/getConfig
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password

10 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Return Example:
{
“data”: { // Set parameters
“companyName”: “smdt”,
“deviceId”: 86,
“displayCustom”: “{name}”,
“displayMode”: 1,
“id”: 1,
“liveIdentiLevel”: 1,
“passType”: false,
“password”: “123456”,
“recoDistance”: “1.5”,
“recoInterval”: “2000”,
“relayDelay”: 5,
“relayMode”: 0,
“serialCustomize”: “#{idcardNum}#”,
“serialMode”: 2,
“similarity”: 80,
“strangerVoiceCustom”: “moshengren”,
“strangerVoiceMode”: 2,
“voiceCustom”: “name”,
“voiceMode”: 1,
“wg”: 0
},
“result”: 1, // Interface access
“success”: true // Setting successful
}
2.5 PERSONNEL REGISTRATION
Request method: POST request
Request address: http://device ip:8080/person/create
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
person Json YPersonnel information Json The following are the parameters of json

11
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Request description
POST request parameters are placed in the body
The base64 string of the photo, without the header, such as: data: image/jpg; base64. Staff photos only support JPG and PNG.
PERSON FIELD
FIELD MODE DESCRIPTION
age int age
imgBase64 String imgBase64 String
name String name
prescription String yyyy-MM-dd
HH:mm,yyyy-MM-dd HH:mm
sex int sex
type Int Type
The default is 1, 1 for visitors, 2 blacklists, and 3 for employees.
vipID Int Create a person’s id, find the person’s editor based on the id
welcome String Reserved, can be left blank
icCard String ic card information
card String ID CARD no
wn String Reserved, can be left blank
RETURN Example:
{
“data”: “msg: Successful registration “,
“result”: 1,
“success”: true
}
Registration failed, return failure description, the corresponding error code is as follows.
2.6 PERSONNEL INFORMATION EDITING
Request method: POST request
Request address: http://device ip:8080/person/update
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
person Json YPersonnel information Json The following are the parameters of json

12 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
request
POST request parameters are placed in the body
The base64 string of the photo, without the header, such as
Staff photos only support JPG and PNG
PERSON PARAMETER DESCRIPTION
FIELD MODE DESCRIPTION
age int age
imgBase64 String imgBase64 String
name String Name
prescription String yyyy-MM-dd
HH:mm,yyyy-MM-dd HH:mm
sex int sex
type int Type The default is 1, 1 for visitors, 2 blacklists, and 3 for employees.
vipID Int Create a person’s id, find the person’s editor based on the id
welcome String Reserved, can be left blank
icCard String ic card information
card String ID number
wn String Reserved, can be left blank
Example of returned data:
{
“data”: “msg: Staff editing success “,
“result”: 1,
“success”: true
}
2.7 DELETE PERSON
Request method: POST request
Request address: http://device ip:8080/person/delete

13
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
deleteId String YDelete person id
Return Example:
{
“data”: “msg: Person deleted successfully
“result”: 1,
“success”: true
}
2.8 IDENTIFICATION RECORD ACQUISITION
Request method: POST request
Request address: http://device ip:8080/newFindRecords
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
startTime String Ystart: 2019-07-11 12:00
endTime String Yfinish: 2019-07-11 17:00
{
“data”: [
{
“birthDate”: “”,//reserved
“currentTime”: 1562819094334, // Transit time, milliseconds
“idCardNum”: “”,// staff ID
“imageFlag”: 0,// The name of the photo taken by the public, if you want to get the photo, please call getRecordImg interface to
get it.
“
“name”: “pdf”, //passer name
“type”: 1, //mode
“temperature”: “36.5”, // Body temperature when passing, transmitted when body temperature detection is off -1
“mask”: 1 // Whether to wear a mask: 1 wear, 0: no wear mask, -1 when mask detection is closed},
{
“birthDate”: “”,
“currentTime”: 1562824109687,
“idCardNum”: “”,
“imageFlag”: 0,
“imageName”: “1_86_1562824109687.jpg”,

14 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
“name”: “pdf”,
“type”: 1
“temperature”: “36.5”,
“mask”: 1 // Whether to wear a mask, 1: worn, 0: not worn
},
{
“birthDate”: “”,
“currentTime”: 1562825856546,
“idCardNum”: “null”,
“imageFlag”: 1,
“imageName”: “100_86_1562825856546.jpg”,
“name”: “tts”,
“type”: 1,
“temperature”: “36.5” ,
“mask”: 1 // Whether to wear a mask: 1 wearing, 0 not wearing
“birthDate”: “”,
“currentTime”: 1562825856546,
“idCardNum”: “null”,
“imageFlag”: 1,
“imageName”: “100-86-1562825856546.jpg”,
“name”: “tts”,
“type” :1,
“temperature”: “36.5”,
“mask”: 1 //Whether to wear a mask: 1 wearing; 0 not wearing
}
],
“result”: 1, // Interface transfer through
“success”: true // success
2.9 MODIFY LOGO
Request method: POST request
Request address: http://device ip:8080/changeLogo
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String Ydevice
imgBase6 4 String YLogo pic Base64, only supports png, jpg

15
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Request:
POST request parameters are placed in the body
The base64 string of the photo, without the header, such as: data:image/jpg;base65
Staff photos only support JPG and PNG
Example:
{
“data”: “msg: logo modify successfully”,
“result”: 1,
“success”: true
}
2.10 ACQUISITION OF EQUIPMENT MAC ADDRESS
Request method: POST request
Request address: http://device ip:8080/getDeviceMac
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
Example:
{
“data”: “8CFCA0000023”,
“result”: 1,
“success”: true
}
2.11 PARAMETER CONFIGURATION (BODY TEMPERATURE, MASK, FAN, ETC.)
Request method: POST request
Request address: http://device ip:8080/tempAndMaskSetting
REQUEST DATE
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
config Json YPersonnel information Json. The following are the parameters of json

16 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Request description
POST request parameters are placed in the body.
The config request parameter is in json format; an example follows (adjust according to the actual situation).
{
“isBodyTempAlarm”: 1,
“isBodyTempStart”: 1,
“isHighFeverAdopt”: 0,
“isLowFeverAdopt”: 0,
“isLowTempAdopt”: 0,
“isStandardTempAdopt”: 1,
“isWearingMask”: 0,
“standardBodyTemp”: “37.3”,
“isStrangerRecord”:0,
“isFan”:0
}
config description
REQUEST DATE
FIELD MODE REQUEST
isBodyTempAlarm int 1: Turn on body temperature alarm; 0: Turn off body temperature alarm
isBodyTempStart Int 1: Turn on body temperature detection; 0: Turn off body temperature detection
standardBodyTemp String
Body temperature threshold 37.3 (accurate to one decimal place), open body temperature detection
and body temperature alarm. After detecting that the body temperature exceeds the threshold, a
sound alarm is played.
isHighFeverAdopt int Whether high fever passed (0: not passed; 1: passed) is used to open the door (range 38.5–43.0)
isLowFeverAdopt int Whether high fever passed (0: not passed 1: passed) is used to open the door (range 38.5–43.0)
isLowTempAdopt int Whether the low temperature is passed (0: not passed; 1: passed) for door opening (range 30.0 and
below)
isStandardTempAdopt int Whether the normal body temperature is passed (0: not passed 1: passed) for opening the door
(range 36.1–37.2)
isWearingMask int Wear mask detection switch (0: No; 1: Yes)
isStrangerRecord int Stranger identification record storage switch (0: No; 1: Yes)
isFan int Fan switch (0: No; 1: Yes)
tempCompensation float Temperature compensation, range (-1–1), positive number means positive compensation, negative
number means negative compensation

17
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Example:
{
“data”: {
“deviceId”: 88,
“id”: 10,
“isBodyTempAlarm”: 1,
“isBodyTempStart”: 1,
“isHighFeverAdopt”: 0,
“isLowFeverAdopt”: 0,
“isLowTempAdopt”: 0,
“isStandardTempAdopt”: 1,
“isWearingMask”: 0,
“standardBodyTemp”: “37.3”,
“isStrangerRecord”:0,
“isFan”:0
},
“result”: 1,
“success”: true
}
2.12 ACCESS TO PHOTOS
Request method: POST request
Request address: http://device ip: 8080/getRecordImg
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice
imgName String YPhoto name (obtained by the identification record interface)
Example:
{
“data”:“/9j/4AAQSkZJRgABAQAAAQABAAD/2wB”, // Image’s base64 string
“result”: 1, //1 Interface call 0 Interface abnormal
“success”: true // true Get success false Get failure;
}

18 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
2.13 DEVICE PARAMETER INFORMATION ACQUISITION
Request method: POST request
Request address: http://device ip: 8080/getDeviceInfo
Request data: /getDeviceInfo
Request data:
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
Example:
{
“data”:”{“freeSpace”:”3.61GB”, // freeSpace: Remaining storage space
“ip”:”192.9.51.45”, //ip:ip address
“mac”:”8CFCA0036225”, // mac adress
“time”:1584518232928, // System time (ms) long type
“version”:”1.5.0.22.0.01” // app Current version number
}”,
“result”: 1,
“success”: true
}
2.14 TAKING PICTURES
Request method: POST request
Request address: http://equipment ip: 8080/photograph
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
Example:
{
“data”: “/9j/4AAQSkZJRgABAQAA …”, //base64 String, need to be converted to suffix png pictures
“result”: 1,
“success”: true
}

19
1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
2.15 DEVICE INITIALIZATION
Request method: POST request
Request address: http://device ip: 8080/initialization
Request data:
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
Request description:
• Delete all identification records, personnel data, characteristics, and other data on the device, and clear all databases.
• Delete the attributes set through the device configuration interface.
Example:
{
“data”: “ Initialization successful “,
“result”: 1,
“success”: true
}
2.16 SYSTEM TIME SETTING
Request method: POST request
Request address: http://device ip: 8080/setDeviceTime
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
year String Yyear
month String Ymonth
day String Yday
hours String Yhours
minute String Yminute
Request description:
After successful configuration, the device time is changed to the currently set time. If the device is connected to the public network, the
device itself has a network time calibration mechanism, and the system adjusts the device time to the public network time. For the device
to display the time manually set, the device must be in the local area network. If connected to the public network, the device uses the
public network time by default when refreshing its time.

20 1. 8 7 7. 8 7 7. 2 2 6 9 BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877. 2 269
CHAPTER 2: DYNAMIC DETECTION DISPLAY LAN INT. V1.4
Example:
{
“data”: “2020-03-15 22:10:50”, // Device current time
“result”: 1,
“success”: true
}
2.17 IDENTIFY THE RECORDING INTERFACE CALLBACK SETTINGS
Request method: POST request
Request address: http://device ip: 8080/setIdentifyCallback
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password
callbackUrl String YIdentify the url interface for record upload
Request description:
The callback can be set in other settings of the APP terminal settings.
Example:
{
“data”: “http://192.9.51.45:8080/setIdentifyCallback”,
“result”: 1, //1 Set successfully -1 No callbackUrl field -2 callbackUrl Field is empty
 “success”:true//trueSetsuccessfully,falsesetfailed；
}
2.18 DEVICE DOOR CONTROL
Request method: POST request
Request address: http://device ip: 8080/device/openDoorControl
REQUEST DATA
FIELD MODE REQUEST DESCRIPTION
pass String YDevice password