HikCentral Professional OpenAPI

HikCentral Professional OpenAPI
Developer Guide
HikCentral Professional OpenAPI Developer Guide
Legal Information
© 2023 Hangzhou Hikvision Digital Technology Co., Ltd. All rights reserved.
This Document (hereinafter referred to be "the Document") is the property of Hangzhou Hikvision
Digital Technology Co., Ltd. or its affiliates (hereinafter referred to as "Hikvision"), and it cannot be
reproduced, changed, translated, or distributed, partially or wholly, by any means, without the
prior written permission of Hikvision. Unless otherwise expressly stated herein, Hikvision does not
make any warranties, guarantees or representations, express or implied, regarding to the
Document, any information contained herein.
LEGAL DISCLAIMER
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE DOCUMENT IS PROVIDED "AS IS"
AND "WITH ALL FAULTS AND ERRORS". HIKVISION MAKES NO REPRESENTATIONS OR WARRANTIES,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. IN NO EVENT WILL HIKVISION BE
LIABLE FOR ANY SPECIAL, CONSEQUENTIAL, INCIDENTAL, OR INDIRECT DAMAGES, INCLUDING,
AMONG OTHERS, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS
OF DATA, CORRUPTION OF SYSTEMS, OR LOSS OF DOCUMENTATION, WHETHER BASED ON BREACH
OF CONTRACT, TORT (INCLUDING NEGLIGENCE), OR OTHERWISE, IN CONNECTION WITH THE USE
OF THE DOCUMENT, EVEN IF HIKVISION HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES OR LOSS.
i
Contents
Chapter 1 Overview .................................................................................................................... 1
1.1 Introduction ........................................................................................................................... 1
1.2 System Requirements ............................................................................................................ 1
1.3 Open Capabilities ................................................................................................................... 1
1.3.1 Resource Capability ....................................................................................................... 2
1.3.2 Video Capability ............................................................................................................ 3
1.3.3 Event and Alarm Capability ........................................................................................... 4
1.3.4 Vehicle and Parking Management Capability ................................................................ 5
1.3.5 Access Control Capability .............................................................................................. 5
1.3.6 Visitor Management Capability .................................................................................... 6
1.3.7 On-Board Monitoring Capability ................................................................................... 7
1.3.8 Digital Signage Capability .............................................................................................. 7
1.4 Terms and Definitions ............................................................................................................ 8
1.5 Update History ....................................................................................................................... 9
Chapter 2 Getting Started ......................................................................................................... 20
2.1 Installation ........................................................................................................................... 20
2.2 Configuration ....................................................................................................................... 23
2.2.1 Authenticate Service Certificate ................................................................................. 23
2.2.2 Enable Open Platform ................................................................................................. 24
2.3 Run Open Platform .............................................................................................................. 25
Chapter 3 Protocol Summary .................................................................................................... 28
3.1 Request and Response Rule ................................................................................................. 28
3.1.1 Request ....................................................................................................................... 28
3.1.2 Response ..................................................................................................................... 29
3.2 Signature and Authentication .............................................................................................. 31
Chapter 4 Typical Applications .................................................................................................. 35
ii
4.1 Manage Resources ............................................................................................................... 35

4.1.1 Get Physical Resources' Information ........................................................................... 35
4.1.2 Get Logical Resources' Information ............................................................................ 37
4.2 Get Video and Audio Stream ............................................................................................... 43
4.3 Control PTZ .......................................................................................................................... 48
4.4 Configure Generic Event ...................................................................................................... 48
4.5 Receive Alarm or Event ........................................................................................................ 49
4.6 Search for Events and Get Picture ........................................................................................ 51
4.7 Manage Person's Access Level ............................................................................................. 52
4.8 Control Door Status ............................................................................................................. 54
4.9 Manage Vehicle Parking ....................................................................................................... 54
4.10 Manage Visitors ................................................................................................................. 60
4.11 Manage On-Board Monitoring ........................................................................................... 62
4.12 Search for Person ............................................................................................................... 66
4.13 Manage Digital Signage ...................................................................................................... 68
Chapter 5 API Reference ........................................................................................................... 69
5.1 Common API ........................................................................................................................ 69
5.1.1 POST /artemis/api/common/v1/version ..................................................................... 69
5.2 Physical Resources API ......................................................................................................... 70
5.2.1 POST /artemis/api/resource/v1/acsDevice/acsDeviceList .......................................... 70
5.2.2 POST /artemis/api/resource/v1/acsDevice/advance/acsDeviceList ........................... 72
5.2.3 POST /artemis/api/resource/v1/acsDevice/indexCode/acsDeviceInfo ....................... 74
5.2.4 POST /artemis/api/resource/v1/encodeDevice/advance/encodeDeviceList .............. 75
5.2.5 POST /artemis/api/resource/v1/encodeDevice/encodeDeviceList ............................. 77
5.2.6 POST /artemis/api/resource/v1/encodeDevice/indexCode/encodeDeviceInfo ......... 79
5.2.7 POST /artemis/api/resource/v1/intelligentServer/intelligentServerList ..................... 81
5.2.8 POST /artemis/api/resource/v1/mobileDevice/mobileDeviceList .............................. 83
5.2.9 POST /artemis/api/resource/v1/mobileDevice/indexCode/mobileDeviceInfo ........... 85
iii
5.2.10 POST /artemis/api/resource/v1/mobileDevice/advance/mobileDeviceList ............. 86

5.2.11 POST /artemis/api/resource/v1/recordServer/indexCode/recordServerInfo ........... 88
5.2.12 POST /artemis/api/resource/v1/recordServer/recordServerList .............................. 90
5.2.13 POST /artemis/api/resource/v1/recordServer/recordStatus .................................... 92
5.2.14 POST /artemis/api/resource/v1/streamServer/streamServerList ............................. 94
5.2.15 POST /artemis/api/resource/v1/videoManagementServer ...................................... 96
5.3 Logical Resources API ........................................................................................................... 98
5.3.1 Site Information .......................................................................................................... 98
5.3.2 Area Information ....................................................................................................... 103
5.3.3 Camera Information .................................................................................................. 111
5.3.4 Organization Information .......................................................................................... 121
5.3.5 Access Point Information .......................................................................................... 134
5.3.6 Vehicle Information ................................................................................................... 143
5.3.7 Vehicle Linked to On-Board Device ........................................................................... 161
5.3.8 Person Information ................................................................................................... 168
5.3.9 Face Comparison Group ............................................................................................ 198
5.3.10 Face Information ..................................................................................................... 210
5.3.11 Alarm Input/Output Information ............................................................................ 217
5.4 Video API ............................................................................................................................ 230
5.4.1 POST /artemis/api/aiapplication/v1/people/statisticsTotalNumByTime .................. 231
5.4.2 POST /artemis/api/aiapplication/v1/people/resourceGroupRealTimeCount ........... 233
5.4.3 POST /artemis/api/aiapplication/v1/people/advance/resourceGroupList ............... 235
5.4.4 POST /artemis/api/aiapplication/v1/people/statisticsHeatMapByTime ................... 236
5.4.5 POST /artemis/api/video/v1/cameras/playbackURLs ............................................... 239
5.4.6 POST /artemis/api/video/v1/cameras/previewURLs ................................................ 242
5.4.7 POST /artemis/api/video/v2/cameras/previewURLs ................................................ 244
5.4.8 POST /artemis/api/video/v1/cameras/talkURLs ....................................................... 246
5.4.9 POST /artemis/api/video/v1/device/talkURLs .......................................................... 247
iv
5.4.10 POST /artemis/api/video/v1/patrols/addition ........................................................ 249

5.4.11 POST /artemis/api/video/v1/patrols/deletion ........................................................ 251
5.4.12 POST /artemis/api/video/v1/patrols/patrolIndex/patrolInfo ................................. 252
5.4.13 POST /artemis/api/video/v1/patrols/searches ....................................................... 253
5.4.14 POST /artemis/api/video/v1/presets/addition ....................................................... 255
5.4.15 POST /artemis/api/video/v1/presets/deletion ....................................................... 256
5.4.16 POST /artemis/api/video/v1/presets/searches ...................................................... 258
5.4.17 POST /artemis/api/video/v1/ptzs/controlling ......................................................... 259
5.4.18 POST /artemis/api/video/v1/camera/capture ........................................................ 262
5.4.19 POST /artemis/api/video/v1/download .................................................................. 263
5.4.20 POST /artemis/api/video/v1/downloadURL ........................................................... 265
5.4.21 POST /artemis/api/video/v1/event/searchLabels ................................................... 267
5.5 Alarm and Event API .......................................................................................................... 270
5.5.1 POST /artemis/api/eventService/v1/eventRecords/controlling ................................ 270
5.5.2 POST /artemis/api/eventService/v1/eventRecords/page ......................................... 271
5.5.3 POST /artemis/api/eventService/v1/eventSubscriptionByEventTypes ..................... 275
5.5.4 POST /artemis/api/eventService/v1/eventSubscriptionView ................................... 277
5.5.5 POST /artemis/api/eventService/v1/eventUnSubscriptionByEventTypes ................ 278
5.5.6 POST /artemis/api/eventService/v1/generalEventRule/generalEventRuleList ......... 280
5.5.7 POST /artemis/api/eventService/v1/generalEventRule/single/add .......................... 282
5.5.8 POST /artemis/api/eventService/v1/generalEventRule/single/delete ...................... 283
5.5.9 POST /artemis/api/eventService/v1/generalEventRule/single/update .................... 285
5.5.10 POST /artemis/api/eventService/v1/generalEventRule/triggerAlarm .................... 286
5.5.11 POST /artemis/api/eventService/v1/image_data ................................................... 288
5.5.12 POST /artemis/api/eventService/v1/deviceApplicationEvent ................................ 290
5.6 Visitor API .......................................................................................................................... 292
5.6.1 POST /artemis/api/visitor/v1/appointment .............................................................. 292
5.6.2 POST /artemis/api/visitor/v1/appointment/update ................................................. 295
v
5.6.3 POST /artemis/api/visitor/v1/registerment .............................................................. 298

5.6.4 POST /artemis/api/visitor/v1/registerment/update ................................................. 302
5.6.5 POST /artemis/api/visitor/v2/appointment .............................................................. 305
5.6.6 POST /artemis/api/visitor/v1/appointment/single/delete ....................................... 308
5.6.7 POST /artemis/api/visitor/v2/appointment/update ................................................. 309
5.6.8 POST /artemis/api/visitor/v1/visitor/out .................................................................. 313
5.6.9 POST /artemis/api/visitor/v1/appointment/appointmentlist ................................... 314
5.6.10 POST /artemis/api/visitor/v1/appointment/downloadpicture ............................... 317
5.6.11 POST /artemis/api/visitor/v1/visitorconfig/customfields ....................................... 319
5.6.12 POST /artemis/api/visitor/v1/visitorgroups ............................................................ 321
5.6.13 POST /artemis/api/visitor/v1/visitorgroups/groupinfo ........................................... 322
5.6.14 POST /artemis/api/visitor/v1/visitor/visitorInfo ..................................................... 325
5.6.15 POST /artemis/api/visitor/v1/visitor/single/visitorinfo .......................................... 326
5.6.16 POST /artemis/api/visitor/v1/auth/reapplication ................................................... 327
5.7 Vehicle and Parking API ...................................................................................................... 328
5.7.1 POST /artemis/api/pms/v1/image_data ................................................................... 328
5.7.2 POST /artemis/api/pms/v1/crossRecords/page ........................................................ 330
5.7.3 POST /artemis/api/vehicle/v1/parkinglot/list ........................................................... 333
5.7.4 POST /artemis/api/vehicle/v1/floor/list ................................................................... 334
5.7.5 POST /artemis/api/vehicle/v1/floor/overview ......................................................... 336
5.7.6 POST /artemis/api/vehicle/v1/floor/parkingspace/status ........................................ 339
5.7.7 POST /artemis/api/vehicle/v1/parkinglot/passageway/record ................................ 341
5.7.8 POST /artemis/api/vehicle/v1/parkingspace/record ................................................ 345
5.7.9 POST /artemis/api/vehicle/v1/parkingfee/calculate ................................................ 348
5.7.10 POST /artemis/api/vehicle/v1/parkingfee/confirm ................................................ 350
5.7.11 POST /artemis/api/vehicle/v1/vehicle/blocklist/add .............................................. 351
5.7.12 POST /artemis/api/vehicle/v1/vehicle/blocklist/get ............................................... 353
5.7.13 POST /artemis/api/vehicle/v1/vehicle/blocklist/modify ........................................ 355
vi
5.7.14 POST /artemis/api/vehicle/v1/vehicle/blocklist/delete .......................................... 358

5.8 Access Control API ............................................................................................................. 359
5.8.1 POST /artemis/api/acs/v1/auth/applicationResult ................................................... 359
5.8.2 POST /artemis/api/acs/v1/door/doControl .............................................................. 361
5.8.3 POST /artemis/api/acs/v1/door/events .................................................................... 363
5.8.4 POST /artemis/api/acs/v1/event/pictures ................................................................ 366
5.8.5 POST /artemis/api/acs/v1/privilege/group ............................................................... 366
5.8.6 POST /artemis/api/acs/v1/privilege/group/single/addPersons ................................ 368
5.8.7 POST /artemis/api/acs/v1/privilege/group/single/deletePersons ............................ 370
5.8.8 POST /artemis/api/acs/v1/privilege/group/single/personList .................................. 372
5.8.9 POST /artemis/api/visitor/v1/auth/reapplication ..................................................... 374
5.8.10 POST /artemis/api/visitor/v1/person/ID/elementDownloadDetail ........................ 375
5.9 On-Board Monitoring API .................................................................................................. 376
5.9.1 POST /artemis/api/mobilesurveillance/v1/gpsdetails .............................................. 376
5.9.2 POST /artemis/api/mobilesurveillance/v1/recordOverview ..................................... 379
5.9.3 POST /artemis/api/mobilesurveillance/v1/single/record ......................................... 382
5.10 Person Search API ............................................................................................................ 386
5.10.1 POST /artemis/api/body/v1/application/pictureRecognition ................................. 386
5.10.2 POST /artemis/api/body/v1/application/pictureModel ......................................... 387
5.10.3 POST /artemis/api/body/v1/application/captureSearch ........................................ 390
5.10.4 POST /artemis/api/frs/v1/application/pictureRecognitionModel .......................... 393
5.10.5 POST /artemis/api/frs/v1/application/captureSearch ............................................ 395
5.11 Digital Signage API ........................................................................................................... 398
5.11.1 POST /artemis/api/focsign/v1/material/dataSource/search .................................. 398
5.11.2 POST /artemis/api/focsign/v1/material/dataSource/update ................................. 399
5.11.3 POST /artemis/api/focsign/v1/material/dataSource/update/batch ....................... 401
Appendix A. Appendixes ......................................................................................................... 403
A.1 Object Description ............................................................................................................. 403
vii
A.1.1 AccessLevel ............................................................................................................... 403

A.1.2 AcsDevInfo ................................................................................................................ 403
A.1.3 AlarmInputInfo ......................................................................................................... 404
A.1.4 AlarmOutputInfo ...................................................................................................... 404
A.1.5 ApplicationErrorResult .............................................................................................. 405
A.1.6 BaseInfo .................................................................................................................... 406
A.1.7 bodyRect ................................................................................................................... 406
A.1.8 bodyTargetInfo .......................................................................................................... 406
A.1.9 CameraInfo ............................................................................................................... 408
A.1.10 CameraRecordStatus .............................................................................................. 410
A.1.11 Card ........................................................................................................................ 411
A.1.12 CertificateStatus ..................................................................................................... 411
A.1.13 characterInfo .......................................................................................................... 411
A.1.14 CustomField ............................................................................................................ 412
A.1.15 dataSourceBatchUpdateList ................................................................................... 413
A.1.16 dataSourceData ...................................................................................................... 413
A.1.17 DeviceError ............................................................................................................. 414
A.1.18 DoorControlResult .................................................................................................. 414
A.1.19 DoorInfo .................................................................................................................. 415
A.1.20 ElementDetail ......................................................................................................... 415
A.1.21 ElementDetailBaseInfo ........................................................................................... 416
A.1.22 ElementStatus ......................................................................................................... 416
A.1.23 EncodeDevInfo ........................................................................................................ 417
A.1.24 eventLabelList ......................................................................................................... 417
A.1.25 eventList ................................................................................................................. 418
A.1.26 EventPic .................................................................................................................. 419
A.1.27 EventRecord ............................................................................................................ 419
A.1.28 face ......................................................................................................................... 420
viii
A.1.29 FaceGroupInfo ........................................................................................................ 421

A.1.30 FaceInfo .................................................................................................................. 421
A.1.31 facePic ..................................................................................................................... 421
A.1.32 FaceMatchRecord ................................................................................................... 422
A.1.33 faceTargetInfo ......................................................................................................... 423
A.1.34 faceTargets .............................................................................................................. 425
A.1.35 FingerPrint .............................................................................................................. 426
A.1.36 fingerPrintUpdateResult ......................................................................................... 426
A.1.37 FloorInfo ................................................................................................................. 427
A.1.38 FloorOverViewInfo .................................................................................................. 427
A.1.39 ForbiddenVehicleInfo .............................................................................................. 428
A.1.40 GeneralEventRule ................................................................................................... 429
A.1.41 gpsInfo .................................................................................................................... 430
A.1.42 HDDInfo .................................................................................................................. 430
A.1.43 IntelligentServerInfo ............................................................................................... 431
A.1.44 LiveViewUrlInfo ...................................................................................................... 431
A.1.45 MobileDeviceInfo ................................................................................................... 432
A.1.46 MobilevehivleInfo ................................................................................................... 432
A.1.47 OrgInfo .................................................................................................................... 433
A.1.48 ParkingFeeCalculate ................................................................................................ 434
A.1.49 ParkingFeeConfirm ................................................................................................. 434
A.1.50 ParkingLotInfo ......................................................................................................... 435
A.1.51 ParkingRecordInfo .................................................................................................. 435
A.1.52 ParkingSpaceInfo .................................................................................................... 436
A.1.53 PassingRecordInfo ................................................................................................... 437
A.1.54 PassVehicleRecord .................................................................................................. 438
A.1.55 PatrolInfo ................................................................................................................ 439
A.1.56 PatrolPointInfo ........................................................................................................ 440
ix
A.1.57 PeopleCountInfo ..................................................................................................... 441

A.1.58 PeopleCountingParam ............................................................................................ 441
A.1.59 PersonInfo ............................................................................................................... 441
A.1.60 PersonInOutEvents ................................................................................................. 443
A.1.61 PersonPhoto ........................................................................................................... 444
A.1.62 picInfo ..................................................................................................................... 444
A.1.63 PlaybackUrlVideoInfo ............................................................................................. 445
A.1.64 PresetInfo ............................................................................................................... 446
A.1.65 PresetValue ............................................................................................................. 446
A.1.66 PrivilegeGroupInfo .................................................................................................. 446
A.1.67 ReaderInfo .............................................................................................................. 447
A.1.68 RealPeopleCountInfo .............................................................................................. 447
A.1.69 RecordOverview ..................................................................................................... 448
A.1.70 RelatedResourceInfo ............................................................................................... 449
A.1.71 RecordServerInfo .................................................................................................... 450
A.1.72 RegionInfo ............................................................................................................... 451
A.1.73 RelatedErrorInfo ..................................................................................................... 451
A.1.74 ResourceGroupInfo ................................................................................................. 452
A.1.75 SiteInfo .................................................................................................................... 452
A.1.76 SpaceTypeOverViewInfo ......................................................................................... 452
A.1.77 StatisticResult ......................................................................................................... 453
A.1.78 StreamServerInfo .................................................................................................... 453
A.1.79 SubscriptionInfo ...................................................................................................... 454
A.1.80 tableInfo ................................................................................................................. 455
A.1.81 TimeSchedule ......................................................................................................... 455
A.1.82 TimeZoneInfo .......................................................................................................... 455
A.1.83 TwoWayAudioUrlInfo .............................................................................................. 456
A.1.84 VehicleGroupInfo .................................................................................................... 457
x
A.1.85 VehicleInfo .............................................................................................................. 457

A.1.86 Version .................................................................................................................... 458
A.1.87 VideoInfo ................................................................................................................ 458
A.1.88 Visitor ..................................................................................................................... 459
A.1.89 VisitorappointInfo ................................................................................................... 459
A.1.90 VisitorInfo ............................................................................................................... 461
A.1.91 VisitorPhoto ............................................................................................................ 462
A.2 Event Message Format ...................................................................................................... 463
A.2.1 Access Control Event Message ................................................................................. 465
A.2.2 ANPR Event Message ................................................................................................ 466
A.2.3 License Plate Matched or Mismatched Event Message ............................................ 466
A.2.4 Face Comparison Event Message ............................................................................. 467
A.2.5 On-Board Monitoring Event Message ...................................................................... 469
A.3 Data Dictionary .................................................................................................................. 472
A.4 Event Types or Alarm Categories ....................................................................................... 477
A.5 Status or Error Code .......................................................................................................... 486
xi
Chapter 1 Overview
1.1 Introduction
HikCentral Professional is a platform that provides the open capabilities and APIs of video, alarm,
ANPR (Automatic Number Plate Recognition), and so on, for the third-party manufacturers or
developers to fast integrate different applications.
1.2 System Requirements

Operating System: Microsoft® Windows 7 SP1/8.1/10 (64-bit)
Note
The system requirements of Open Platform is same as that of HikCentral Professional.
1.3 Open Capabilities

The open capabilities of HikCentral Professional for application integration include resource, video,
event and alarm (face comparison event, abnormal temperature alarm, no mask alarm, etc.),
vehicle and parking management, access control, etc.
Figure 1-1 Open Capabilities Directory
1
1.3.1 Resource Capability

The resource capability is about getting different resources' information, such as encoding device,
area, camera, vehicle passing, site, and so on in different development modes (i.e., web, computer,
mobile phone, etc.).
Figure 1-2 Resource Capability Directory
2
1.3.2 Video Capability

The video capability is about getting real-time, playback, and audio stream URLs, PTZ control of
remote site, real-time and playback stream transmission, and so on.
Figure 1-3 Video Capability Directory
Note
The OpenAPI only helps to get the real-time or recorded stream, so the implementations of live
view and playback depend on the player developed by the APIs of C++ or C# language SDK or the
video plug-in developed via web browser. For details, refer to the HikCentral Professional Video
SDK (C++) Developer Guide and HikCentral Professional Video Web SDK Developer Guide.
3
1.3.3 Event and Alarm Capability

The event capability is about event subscription by event type, event notification based on HTTP or
HTTPS, generic event configuration, log search, getting event and alarm picture, and alarm
acknowledgement.
Figure 1-4 Event and Alarm Capability Directory
4
1.3.4 Vehicle and Parking Management Capability

The vehicle and parking management capability is about vehicle management and vehicle parking
management.
Figure 1-5 Vehicle and Parking Management Capability Directory
1.3.5 Access Control Capability

The access control capability is about the door control, access record search, and getting access
control event pictures.
5
Figure 1-6 Directory of Access Control Capability Directory
1.3.6 Visitor Management Capability

The visitor management capability is about making reservations for visitors, checking in visitors
with/without reservation information, and checking out visitors.
6
Figure 1-7 Visitor Management Capability Directory
1.3.7 On-Board Monitoring Capability

The on-board monitoring capability is about searching for driving events and getting GPS
information report.
Figure 1-8 On-Board Monitoring Capability Directory
1.3.8 Digital Signage Capability

The digital signage capability is about searching for the data source, updating the data source, and
batch updating data sources.
Figure 1-9 Digital Signage Capability Directory
7
1.4 Terms and Definitions
Term Description
OpenAPI The publicly available application programming interface that
provides developers with programmatic access to a proprietary
software application or web service.
HikCentral Professional A platform for security video management.
HTTP method A set of request methods defined by HTTP to indicate the
desired action to be performed for a given resource. The useful
methods include GET (get resources), PUT (set or update
resources), POST (add or search resources), and DELETE (delete
resources).
header The supplemental data at the beginning of a data block. For
example, "Accept:text/plain".
URL Uniform Resource Locator, which is colloquially termed a web
address, and is a reference to a web resource that specifies its
location on a computer network and a mechanism for retrieving
it.
query A precise request for information retrieval with database and
information systems.
appKey\appSecret A pair of appKey or appSecret is used to mark the caller, and the
appSecret is as a key for signature calculation.
AK Access Key, which relates with the private access key. They are
used in pair to encrypt the signature in the request.
SK Secret Access Key, which is used to mark the sender and prevent
the request from being modified during signature encryption.
SMS Stream Media Server, which supports RTSP and is used to
forward stream to up to 200 channels. It is also like a security
gateway in multi-channel scene.
RTSP Real Time Streaming Protocol, which is a network control
protocol designed for use in entertainment and communications
systems to control streaming media servers. The protocol is used
for establishing and controlling media sessions between end
points. Clients of media servers issue VHS-style commands, such
as play, record and pause, to facilitate real-time control of the
8
Term Description
media streaming from the server to a client (Video On Demand)
or from a client to the server (Voice Recording).
RTP Real-time Transport Protocol, which is a network protocol for
delivering audio and video over IP networks.
1.5 Update History
Summary of Changes in Version 2.4_Jan., 2023

1. Changed "mobile monitoring" and "mobile device" to "on-board monitoring" and "on-board
device".
2. Added APIs for getting the video and audio stream:
Download recordings by obtained playback URL and returned information: POST /artemis/api/
video/v1/download ;
Get the download progress and download URL: POST /artemis/api/video/v1/downloadURL .
3. Added APIs for searching for person:
Detect and model faces in the picture: POST /artemis/api/frs/v1/application/
pictureRecognitionModel ;
Get matched faces by face picture comparison: POST /artemis/api/frs/v1/application/
captureSearch ;
Detect human body and get the human body coordinates: POST /artemis/api/body/v1/
application/pictureRecognition
Get the human body modeling data according to the coordinates: POST /artemis/api/body/v1/
application/pictureModel ;
Get matched human bodies by body picture comparison and get the target picture information:
POST /artemis/api/body/v1/application/captureSearch .
4. Added APIs for managing digital signage:
Search for data source: POST /artemis/api/focsign/v1/material/dataSource/search ;
Update the data source: POST /artemis/api/focsign/v1/material/dataSource/update ;
Batch update the data source: POST /artemis/api/focsign/v1/material/dataSource/update/
batch .
5. Person information APIs:
Added an API for adding a custom field: POST /artemis/api/resource/v1/person/customFields/
single/add ;
Added an API for editing the custom field information: POST /artemis/api/resource/v1/person/
customFields/single/modify ;
Added an API for deleting a custom field: POST /artemis/api/resource/v1/person/
customFields/single/delete .
Added 2 parameters isPublic and isShow for CustomField .
9
6. Access control APIs:

Added an API for getting the access level application information of a visitor: POST /
artemis/api/visitor/v1/person/ID/elementDownloadDetail
7. Video APIs:
Extended and edited the description and note for POST /artemis/api/video/v1/cameras/
playbackURLs .
Added an API for capturing real-time pictures via camera: POST /artemis/api/video/v1/
camera/capture .
Added an API for getting the tags of the person/vehicle-detected videos: POST /artemis/api/
video/v1/event/searchLabels .
8. Alarm and Event APIs:
Extended the description and note, and added a request parameter passBackfor POST /
artemis/api/eventService/v1/eventSubscriptionByEventTypes .
Added a response parameter passBack for POST /artemis/api/eventService/v1/
eventSubscriptionView .
Added an API for searching for AIOP and HEOP event lists by condition: POST /artemis/api/
eventService/v1/deviceApplicationEvent .
9. Added a request parameter isHumanSearchPic for POST /artemis/api/frs/v1/application/
picture .
10. Added a parameter timeZone for AcsDevInfo , EncodeDevInfo and MobileDeviceInfo : added
an object description TimeZoneInfo accordingly.
11. Added a parameter vehicleDirectionType for PassVehicleRecord .
12. Added a value for the parameter gender for VisitorInfo .
13. Added AIOP event and HEOP event to camera alarms.
Summary of Changes in Version 2.3.1_Oct., 2022

Extended the request message for POST /artemis/api/resource/v1/camera/advance/cameraList ,
POST /artemis/api/resource/v1/cameras , and POST /artemis/api/resource/v1/regions/
regionIndexCode/cameras : added a parameter bRecordSetting (whether to get the recording
settings).
Summary of Changes in Version 2.3_Jun., 2022
1. Extended the description for searching for specified organization information by condition
( POST /artemis/api/resource/v1/org/advance/orgList ).
2. Extended the request and response message for adding a vehicle ( POST /artemis/api/
resource/v1/vehicle/single/add ) and editing information of a vehicle( POST /artemis/api/
resource/v1/vehicle/single/update ):
added 2 parameters: effectiveDate (start time of vehicle validity) and expiredDate (vehicle
expiry date).
3. Extended the description of the request parameter "visitEndTime" (related API: POST /
artemis/api/visitor/v1/appointment , POST /artemis/api/visitor/v1/appointment/update ,
POST /artemis/api/visitor/v1/registerment , and POST /artemis/api/visitor/v1/registerment/
update ).
10
Extended the response message for checking in a visitor ( POST /artemis/api/visitor/v1/

registerment ):
added a response parameter qrCodeImage (QR code image).
4. Added APIs for getting the video and audio stream:
Batch get streaming URLs for live view: POST /artemis/api/video/v2/cameras/previewURLs ;
Get streaming URL of two-way audio for the device: POST /artemis/api/video/v1/device/
talkURLs .
Added a parameter protocol for getting streaming URL of two-way audio for the camera
( POST /artemis/api/video/v1/cameras/talkURLs ).
Extended the API description and request parameter protocol:
Get the streaming URL for live view: POST /artemis/api/video/v1/cameras/previewURLs .
Get the streaming URL for playback: POST /artemis/api/video/v1/cameras/playbackURLs .
5. Added an API for getting the heat map information of a specific camera ( POST /artemis/api/
aiapplication/v1/people/statisticsHeatMapByTime ).
6. Added a typical application for managing mobile monitoring (search for driving event records,
search for GPS statistics, receive events of vehicles linked to mobile devices, and get people
counting statistics of vehicle linked to mobile device).
7. Added APIs for managing vehicle parking:
- Calculate the vehicle parking fee (related API: POST /artemis/api/vehicle/v1/parkingfee/
calculate ).
- Confirm the payment of parking fee and allow exit (related API: POST /artemis/api/
vehicle/v1/parkingfee/confirm ).
- Manage vehicle information in the blocklist (related API: POST /artemis/api/vehicle/v1/
vehicle/blocklist/add , POST /artemis/api/vehicle/v1/vehicle/blocklist/delete , POST /
artemis/api/vehicle/v1/vehicle/blocklist/modify and POST /artemis/api/vehicle/v1/
vehicle/blocklist/get ).
8. Modified the data type of the parameter speed:
Search for event information of a mobile device: POST /artemis/api/mobilesurveillance/v1/
single/record .
RecordOverview Object Description: RecordOverview .
Modified the data type of the parameter longitude, latitude, direction, and speed for gpsInfo
object description ( gpsInfo ).
Modified the data type of the parameter longitude, latitude, and speed for mobile event
message ( On-Board Monitoring Event Message ).
9. Extended the parameter devResourceType (device resource type) by adding a value
"mobileDevice" (related object descriptions: CameraInfo , AlarmInputInfo , and
AlarmOutputInfo .
10. Extended the stream protocol by adding a value "websocket_s" ( Video Type ).
Extended the parameter "ability" (event category) by adding a value "event_ms" ( Event
Message Format ).
Added 2 resource codes "mobileDevice" and "mobileVehicle" ( Resource Types / Resource
Permission Code ).
11
Summary of Changes in Version 2.2.1_Mar., 2022

1. Added APIs for getting mobile device information:
Get the mobile device list in page: POST /artemis/api/resource/v1/mobileDevice/
mobileDeviceList ;
Get the information of a mobile device by device ID: POST /artemis/api/resource/v1/
mobileDevice/indexCode/mobileDeviceInfo ;
Search the mobile device list: POST /artemis/api/resource/v1/mobileDevice/advance/
mobileDeviceList .
2. Extended the request and response message for getting the camera list of a specified area by
area ID ( POST /artemis/api/resource/v1/regions/regionIndexCode/cameras ), getting the
information of a specified camera by camera ID ( POST /artemis/api/resource/v1/cameras/
indexCode ), getting the information list of all cameras ( POST /artemis/api/resource/v1/
cameras ), and setting search conditions to search the specified cameras ( POST /artemis/api/
resource/v1/camera/advance/cameraList ):
added 2 parameters: deviceType (device type) and devIndexCode (mobile device ID).
3. Extended the request and response message for getting the alarm input information list
( POST /artemis/api/resource/v1/alarmInputs ), setting search condition to search for the
alarm input information ( POST /artemis/api/resource/v1/alarmInput/advance/
alarmInputList ), getting the alarm output information list ( POST /artemis/api/resource/v1/
alarmOutputs ), and setting search condition to search for the alarm output information
( POST /artemis/api/resource/v1/alarmOutput/advance/alarmOutputList ):
added a parameter deviceType (device type).
4. Added APIs for managing information of vehicles linked to mobile devices:
Get the list of vehicles linked to mobile devices: POST /artemis/api/resource/v1/
mobilevehicle/mobilevehicleList ;
Get the information of a vehicle linked to the mobile device: POST /artemis/api/resource/v1/
mobileVehicle/indexCode/mobileVehicleInfo ;
Search the list of vehicles linked to mobile devices: POST /artemis/api/resource/v1/
mobilevehicle/advanced/mobilevehicleList .
5. Added APIs for managing mobile monitoring:
Get GPS statistics information of mobile devices: POST /artemis/api/mobilesurveillance/v1/
gpsdetails ;
Search for event information of a mobile device: POST /artemis/api/mobilesurveillance/v1/
single/record ;
Search for event records of vehicles linked to mobile devices: POST /artemis/api/
mobilesurveillance/v1/recordOverview .
6. Added the mobile event message ( On-Board Monitoring Event Message ).
Summary of Changes in Version 2.2.0_Nov., 2021

1. Extended the request message for adding and editing a visitor's reservation record (related APIs:
POST /artemis/api/visitor/v2/appointment and POST /artemis/api/visitor/v2/appointment/
update ):
12
added a parameter accessInfo (visitor's access permission).

2. Extended the request message for getting the list of reservation records (related API: POST /
artemis/api/visitor/v1/appointment/appointmentlist ):
added 8 parameters: visitorName (visitor's name), companyName (company name),
interviewName (name of the person to be visited), appointCode (reservation code), identiCode
(ID card number), phoneNo (phone number), appointState (reservation status), and
visitorReason (visiting purpose).
3. Added APIs for managing the visitor information:
Search for the custom information about visitors: POST /artemis/api/visitor/v1/visitorconfig/
customfields ;
Search for the information about visitor groups by group name: POST /artemis/api/visitor/v1/
visitorgroups ;
Search for visitors' information by visitor group ID: POST /artemis/api/visitor/v1/visitorgroups/
groupinfo :
Search for visitors' information by condition: POST /artemis/api/visitor/v1/visitor/visitorInfo ;
Get the visitor's information by visitor ID: POST /artemis/api/visitor/v1/visitor/single/
visitorinfo .
4. Added APIs for video application:
Get the list of resource groups: POST /artemis/api/aiapplication/v1/people/advance/
resourceGroupList ;
Get the real-time statistics of resource groups: POST /artemis/api/aiapplication/v1/people/
resourceGroupRealTimeCount .
5. Added an API for searching for the face comparison information: POST /artemis/api/
aiapplication/v1/face/faceMatchRecord .
6. Added APIs for parking lot management. See details in Manage Vehicle Parking .
7. Added 77 alarm/event types related with camera, door, and card swiping. See details in Event
Types or Alarm Categories .
Summary of Changes in Version 2.1.0_May, 2021

1. Added an API to add a visitor's information for checking in: POST /artemis/api/visitor/v1/
registerment .
2. Added an API to edit a visitor's information for checking in: POST /artemis/api/visitor/v1/
registerment/update .
3. Added an API to add a visitor's reservation record: POST /artemis/api/visitor/v2/appointment .
4. Added an API to delete a visitor's reservation record: POST /artemis/api/visitor/v1/
appointment/single/delete .
5. Added an API to edit a visitor's reservation record: POST /artemis/api/visitor/v2/appointment/
update .
6. Added an API to get the list of the reservation records: POST /artemis/api/visitor/v1/
appointment/appointmentlist .
7. Added an API to get the picture of a visitor: POST /artemis/api/visitor/v1/appointment/
downloadpicture .
8. Extended the event message format Event Message Format :
13
added a parameter eventLvl (event level).

9. Extended the request parameters for getting the streaming URL for playback and getting the
streaming URL for live view (related APIs: POST /artemis/api/video/v1/cameras/playbackURLs
and POST /artemis/api/video/v1/cameras/previewURLs ):
added a parameter requestWebsocketProtocol (Streaming type of websocket).
10. For devices added via ISUP, streaming via RTSP is also supported.
11. Extended event types Event Types or Alarm Categories :
added two camera alarm types, i.e., 385052 (Camera Recording Exception Alarm) and (Camera
Recording Recovered Alarm);
added 7 encoding device alarm types, i.e., 385050 (Encoding Device Recording Exception
Alarm), 385051 (Encoding Device Recording Recovered Alarm), 225404 (HDD Bad Sector
Alarm), 225405 (HDD High Temperature Alarm), 225406 (HDD Impact Detection Alarm),
225407 (HDD Severe Failure Alarm), and 66065 (Video Standard Mismatches Alarm).
added three door alarm types, i.e., 198658 (Abnormally Open Door Alarm), 198400 (Open
Door Timeout Alarm), and 198657(Door Open by Force Alarm).
Summary of Changes in Version 2.0.0_Sept., 2020

1. Added an API to get alarm input information according to alarm input ID: POST /artemis/api/
resource/v1/alarmInputs/indexCode .
2. Added an API to get all the alarm input information: POST /artemis/api/resource/v1/
alarmInputs .
3. Added an API to search for alarm input information: POST /artemis/api/resource/v1/
alarmInput/advance/alarmInputList .
4. Added an API to get alarm output information according to alarm output ID: POST /
artemis/api/resource/v1/alarmOutputs/indexCode .
5. Added an API to get all the alarm output information: POST /artemis/api/resource/v1/
alarmOutputs .
6. Added an API to search for alarm output information: POST /artemis/api/resource/v1/
alarmOutput/advance/alarmOutputList .
7. Added an API to control alarm output: POST /artemis/api/resource/v1/alarmOutput/
controlling .
8. Added an API to get card reader information: POST /artemis/api/resource/v1/reader/search .
9. Added an API to get person information according to person ID: POST /artemis/api/
resource/v1/person/personCode/personInfo .
10. Added API to get the person's custom information: POST /artemis/api/resource/v1/person/
customFields .
11. Added API to edit the person's custom information: POST /artemis/api/resource/v1/person/
personId/customFieldsUpdate .
12. Added an API to add visitor information: POST /artemis/api/visitor/v1/appointment .
13. Added an API to update visitor information: POST /artemis/api/visitor/v1/appointment/
update .
14. Added an API to verify the face picture: POST /artemis/api/acs/v1/faceCheck .
14
15. Added an API to revoke visitor's permission after he/she checks out: POST /artemis/api/
visitor/v1/visitor/out .
16. Added APIs to assign access levels to persons and apply persons' access level settings to
device. Refer to Manage Person's Access Level for details.
17. Added APIs to configure generic events. Refer to Configure Generic Event for details.
18. Extended the object about information of an access control device ( AcsDevInfo ):
added one parameter: status (status of the access control device).
19. Extended the person information object ( PersonInfo ):
added three parameters, i.e., personFamilyName (family name of the person),
personGivenName (given name of the person), and customFieldList (custom information).
20. Extended the vehicle information object ( VehicleInfo ):
added two parameters, i.e., personFamilyName (family name of the vehicle owner) and
personGivenName (given name of the vehicle owner).
21. Extended the object about information of a vehicle passing record ( PassVehicleRecord ):
added three parameters, i.e., vehicleColor (vehicle color), vehicleType (vehicle type), and
country (country of the vehicle).
22. Extended the object about information of an access point event ( PersonInOutEvents ):
added four parameters, i.e., personFamilyName (family name of the person),
personGivenName (given name of the person), readerIndexCode (card reader ID), and
readerName (card reader name).
23. Extended the object about information of an encoding device ( EncodeDevInfo ):
added one parameter: status (status of the encoding device).
24. Extended the event types or alarm categories ( Event Types or Alarm Categories ):
added one alarm input alarm category code: 589825 (Alarm Input Alarm);
added one generic event type code: 195 (Generic Event).
25. Extended the face comparison event message Face Comparison Event Message :
added four parameters, i.e., age (age information), ageGroup (age group), gender (gender
information), and value (gender).
Summary of Changes in Version 1.7.0_May, 2020

1. Added APIs to get the information of different servers, i.e., Streaming Server, Recording Server,
DeepinMind Server, and System Management Server, refer to Table 4-3 , Table 4-4 , Table 4-5 ,
and Table 4-6 for details.
2. Added APIs to add, edit, and delete a vehicle group or a vehicle, refer to Table 4-13 for details.
3. Extended the request parameters when adding or editing a person (related APIs: POST /
artemis/api/resource/v1/person/single/add and POST /artemis/api/resource/v1/person/
single/update ):
added two parameters, i.e., "beginTime" and "endTime".
4. Added an API to edit the information of the face linked with the person: POST /artemis/api/
resource/v1/person/face/update .
5. Added an API to edit the information of the fingerprint linked with the person: POST /
artemis/api/resource/v1/person/fingerPrints/update .
15
6. Added an API to get people counting statistics of a camera: POST /artemis/api/

aiapplication/v1/people/statisticsTotalNumByTime .
7. Added an API to get picture data of access control events via URI: POST /artemis/api/acs/v1/
event/pictures .
8. Added an API to get status details of applying person information to device: POST /
artemis/api/acs/v1/auth/applicationResult .
9. Extended the person information object ( PersonInfo ):
added two parameters, i.e., "beginTime" and "endTime".
10. Extended the vehicle information object ( VehicleInfo ):
edited the maximum lengths of "plateNo", "personName", and "phoneNo" to 32 bytes, 256
bytes, and 32 bytes, respectively.
11. Extended the object of access point event information ( PersonInOutEvents ):
added five parameters, i.e., "deviceTime" (event occurred time), "picUri" (captured picture
URI), "temperatureData" (temperature value), "temperatureStatus" (temperature status), and
"wearMaskStatus" (wearing mask or not).
12. Extended the event types or alarm categories ( Event Types or Alarm Categories ):
added two camera alarm category codes: 130 (License Plate Matched Alarm) and 131 (License
Plate Mismatched Alarm);
added multiple door alarm category codes: 198913 (Door Open Alarm), 199169 (Door Closed
Alarm), 198919 (Remote: Door Open Alarm), 199171 (Remote: Door Closed Alarm), 198922
(Remote: Remain Open Alarm), 199172 (Remote: Remain Closed Alarm), 199941 (Unlocked
Alarm), 199942 (Locked Alarm), 198148 (Remaining Closed Started Alarm), 198150 (Remaining
Closed Ended Alarm), 198401 (Remaining Open Started Alarm), 198402 (Remaining Open
Ended Alarm), and 199608 (Card Reader Tampering Alarm);
added two alarm category codes of access control devices: 199708 (Device Tampering Alarm)
and 199709 (Device Tampering Alarm Restored Alarm);
added two person alarm category codes: 193 (Abnormal Temperature Alarm) and 194 (No
Mask Alarm).
13. Extended the access control event message ( Access Control Event Message ):
added a parameter "personCode" (person No.), "PicUrl" (picture URL), "temperatureData"
(temperature value), "temperatureStatus" (temperature status), and "wearMaskStatus"
(wearing mask or not).
14. Added a message format of license plate matched or mismatched event ( License Plate
Matched or Mismatched Event Message ).
15. Extended the face comparison event message ( Face Comparison Event Message ):
added parameters of "temperature" (temperature information object), "temperatureData"
(temperature value), "temperatureStatus" (temperature status), "mask" (mask information
object), and "wearMaskStatus" (wearing mask or not).
16. Extended the request parameters of event search (related API: POST /artemis/api/
eventService/v1/eventRecords/page ):
added two parameters, i.e., "subSrcType" (event source type) and "subSrcIndexs" (event
source No.), for license plate matched or mismatched event search.
17. Extended the fingerprint information object ( FingerPrint ):
16
added a parameter "relatedCardNo" (the linked card No.).

18. Extended event record information object ( EventRecord ):
added two parameters, i.e., "subSrcType" (event source type) and "subSrcIndexs" (event
source No.), for license plate matched or mismatched event search.
19. Added three error codes of OpenAPI Translation Service ( Status or Error Code ): 131 (the
request resource already exists), 132 (the maximum number of resources reached), and 133
(the resource is occupied).
20. Extended the request parameters of card swiping record search (related API: POST /
artemis/api/acs/v1/door/events ):
added two parameters, i.e., "temperatureStatus" (temperature status) and "wearMaskStatus"
(wearing mask or not).
Summary of Changes in Version 1.6.0_Dec., 2019

1. Added an API to get an organization's information: POST /artemis/api/resource/v1/org/
orgIndexCode/orgInfo .
2. Added an API to add an organization: POST /artemis/api/resource/v1/org/single/add .
3. Added an API to edit an organization's information: POST /artemis/api/resource/v1/org/
single/update .
4. Added an API to delete an organization: POST /artemis/api/resource/v1/org/single/delete .
5. Added an API to add a face comparison group: POST /artemis/api/frs/v1/face/group/single/
addition .
6. Added an API to edit the information of a face comparison group: POST /artemis/api/frs/v1/
face/group/single/update
7. Added an API to delete a face comparison group: POST /artemis/api/frs/v1/face/group/batch/
deletion .
8. Added an API to apply face comparison group to device: POST /artemis/api/frs/v1/plan/
recognition/black/restart .
9. Added an API to add a face's information: POST /artemis/api/frs/v1/face/single/addition .
10. Added an API to delete a face's information: POST /artemis/api/frs/v1/face/deletion .
11. Added an API to search for face information in face comparison group: POST /
artemis/api/frs/v1/face
12. Added an API to download face picture via URL: POST /artemis/api/frs/v1/application/
picture
13. Extended the streaming protocol type of live view (related API: POST /artemis/api/video/v1/
cameras/previewURLs ):
added two values "websocket" (for JsDecoder SDK) and "rtsp_s" (for getting stream via
standard RTSP) to the request parameter "protocol".
14. Extended the streaming protocol type of playback (related API: POST /artemis/api/video/v1/
cameras/playbackURLs ):
added a value "websocket" (for JsDecoder SDK) to the request parameter "protocol".
15. Extended the data type of playback URL and video segment information
( PlaybackUrlVideoInfo , related API: POST /artemis/api/video/v1/cameras/playbackURLs ):
added a parameter "recordLocation" (video storage location).
17
16. Extended the storage location types of videos (related data types: PlaybackUrlVideoInfo and
CameraInfo ):
added a value "2" (central cluster storage) the parameter "recordLocation".
17. Extended the data type of video segment information ( VideoInfo , related API: POST /
artemis/api/video/v1/cameras/playbackURLs ):
added two parameters "url" (streaming URL) and "authentication" (authentication
information).
18. Extended the request parameters of adding or editing person (related APIs: POST /
artemis/api/resource/v1/person/single/add and POST /artemis/api/resource/v1/person/
single/update ):
added a parameter "cards" (card information).
19. Extended the data type of person information ( PersonInfo ; related APIs: POST /artemis/api/
resource/v1/person/personList , POST /artemis/api/resource/v1/person/personId/
personInfo , and POST /artemis/api/resource/v1/person/advance/personList ):
added a parameter "cards" (card information).
20. Extended the data type of access point event information ( PersonInOutEvents , related API:
POST /artemis/api/acs/v1/door/events ):
added a parameter "checkInAndOutType" (attendance type).
21. Added a event type code "131659" (Face Picture Comparison) to Event Types or Alarm
Categories .
22. Added three event message examples, i.e., Access Control Event Message , ANPR Event
Message , and Face Comparison Event Message to the "data" parameter of Event Message
Format .
23. Extended the resource capability ( Resource Capability ):
added the capability of managing organizations, face comparison groups, and faces.
Summary of Changes in Version 1.5.1_Oct., 2019

1. Added an API to get the root organization's information: POST /artemis/api/resource/v1/org/
rootOrg .
2. Added an API to get the lower-level organization list by parent organization: POST /artemis/api/
resource/v1/org/parentOrgIndexCode/subOrgList .
3. Added an API to get organization list: POST /artemis/api/resource/v1/org/orgList .
4. Added an API to search for organizations by condition: POST /artemis/api/resource/v1/org/
advance/orgList .
5. Added an API to add a person: POST /artemis/api/resource/v1/person/single/add .
6. Added an API to edit the information of a person: POST /artemis/api/resource/v1/person/
single/update .
7. Added an API to delete a person: POST /artemis/api/resource/v1/person/single/delete .
8. Added an API to get face comparison group list: POST /artemis/api/frs/v1/face/groupList .
9. Added an API to search for face comparison groups: POST /artemis/api/frs/v1/face/group .
10. Added an API to apply person information to device: POST /artemis/api/visitor/v1/auth/
reapplication .
18
11. Extended the data type of person information ( PersonInfo ; related APIs: POST /artemis/api/
resource/v1/person/personList , POST /artemis/api/resource/v1/person/personId/
personInfo , and POST /artemis/api/resource/v1/person/advance/personList ):
added a parameter "orgIndexCode" (organization ID).
12. Extended the resource capability Resource Capability :
added the following capabilities: get or search organizations, manage persons, get and search
face comparison groups, and apply person information to device.
Summary of Changes in Version 1.5.0_Sept., 2019

New document.
19
Chapter 2 Getting Started
2.1 Installation
The Open Platform can be installed with the HikCentral Professional in a same computer or server
(i.e., centralized mode) or in different computers or servers (i.e., distributed mode).
Before You Start
● Make sure you have prepared the proper system environment and installed the HikCentral
Professional.
Note
The compatible versions include version 2.0/2.1/2.2 of HikCentral Professional and version
1.0/1.1 of HikCentral Professional Access Control.
● Make sure you have enabled the License of Third-Party Integration function, see details in the
figure below.
20
Figure 2-1 Enable License of Third-Party Integration
21
Steps
1. Run the executable program HikCentral Professional_OpenAPI.exe as an administrator to enter
the welcome panel of the InstallShield Wizard.
2. Click Next to start the InstallShield Wizard.
3. Read the License Agreement.
- Click I accept the terms of the license agreement and continue.
- Click I do not accept the terms of the license agreement to cancel the installation.
4. Click Next.
5. Perform one of the following operations according to the centralized or distributed installation
mode.
Note
If the event or alarm uploading frequency is larger than 100 times per second, you should adopt
the distributed installation mode.
- For centralized installation mode, click Next to continue.
Note
The default directory C:\Program Files (x86)\HikCentral Professional\VSM Servers\OpenAPI is
used.
- For distributed installation mode, click Change... and select a proper directory as desired to
install the Open Platform.
6. Click Next to continue.
7. Read the pre-install information, and click Install to begin the installation.
A panel indicating progress of the installation displays.
8. Read the post-install information and click Finish to complete the installation.
Four services, i.e., OpenAPI Translation Service, artemis, artemis-web, and artemis-portal, are
generated. And the following documents and software development kits will appear under the
installation directory.
Folder Name File Description

Document HikCentral Professional OpenAPI Provide the RESTful APIs for
Developer Guide integrating different functions.
WebSDK HCVideoSDKWebControl Provide the APIs, introductions, and
HikCentral Professional Video sample codes for developing a video
WebSDK Developer Guide player on the web browser.
Demos
C++SDK HCVideoSDK Provide the APIs using C++ language,
HikCentral Professional Video SDK (C introductions, and sample codes for
++) Developer Guide playing video and audio.
22
Folder Name File Description

HCVideoSDKDemo
C#SDK HikCentral Professional Video SDK Provide the APIs using C# language,
(C#) Demo User Manual introductions, and sample codes for
C#HCSDKDemo playing video and audio.
C++HttpUtillib HttpUtillib DLL Encapsulate the POST methods of
HikCentral Professional OpenAPI HTTP/HTTPS and provide a unified
Security Authentication Library (C++) access of OpenAPI to communicate
Developer Guide with gateway based on HTTP.
HttpUtillib Demo
jsDecoder jsDecoder SDK Provide a no plug-in solution to play
HikCentral Professional Video video via web browser.
jsDecoder SDK Developer Guide
jsDecoder SDK Demo and User
Manual
2.2 Configuration
After installing the services of Open Platform, some configurations should be done to make it
running normally. Especially for the distributed installation mode, the service certificate must be
authenticated. And also, switching the integration mode of HikCentral Professional and enabling
the Open Platform are required.
2.2.1 Authenticate Service Certificate

If the installation of Open Platform services and HikCentral Professional services adopts the
distributed mode, before using the services, the security certificate must be authenticated.
Steps
1. Log in to the HikCentral Professional via the Web Client, refer to HikCentral Professional Web
Client User Manual for details.
2. Select → System Configuration → Security → Service Component Certificate .
23
Figure 2-2 View Service Certificate

3. View and get the service certificate information in the Certificate between Services in System
field.
4. Run the Service Manager as an administrator.
5. Click Security Certificate to open Enter Certificate Information dialog.
6. Enter the obtained service certificate information in the dialog.
7. Click OK.
2.2.2 Enable Open Platform

By default, the Open Platform is disabled. So before the integration, you must enable it in the
HikCentral Professional Web Client.
Steps
1. Log in to the HikCentral Professional via the Web Client, refer to HikCentral Professional Web
Client User Manual for details.
2. Select → System Configuration → Third-Party Integration → Open API .
3. Switch Open API to on.
24
Figure 2-3 Enable Open Platform Page

4. Enter the IP address of Open Platform and the management port No.
Note
The default management port No. is 8208.
5. Check the checkbox to select a partner user.
6. Click Save.
2.3 Run Open Platform

After installing the services and configuring the Open Platform, you can run it and create a partner
for further integration.
Steps
1. In the address bar of the web browser, enter the address of https://IPaddress/artemis-web and
press Enter key.
25
Figure 2-4 Open Platform Login Page

2. Click log in tab to switch to login page.
3. Enter user name and password.
Note
The user names of Open Platform and HikCentral Professional are independent, the default user
name of Open Platform is "admin", and the initial password is "admin@123". For the first time
login, you must change the password.
4. Click log in to log in to the Open Platform.
5. Create a partner.
1) Click Partner Management at the left panel.
2) Click Create a partner to enter Create Partner panel.
Figure 2-5 Create Partner Page

3) Enter the partner name and description.
4) Optional: Add extension fields to the partner.
26
Note
If the domains of the third-party platform and HikCentral Professional are different, you
should an extension field to set the domain information.
5) Click Create to save the added partner information.
The created partner displays on the Partner Management panel. Click on the partner name to
view the details, including APPkey and APPsecret, which are for authentication and marking
the encrypted request.
6) Select a partner and click Authentication in the operating column of the selected partner
item.
Figure 2-6 Assign Permission to Partner Page

7) Select permission(s) to be assigned.
8) Click to assign the selected permissions to the partner.
6. Optional: Perform the request URL test.
1) Click API List at the left panel of Open Platform.
2) Select URL and click Online Debug at the right panel to enter debug page.
Note
The third-party partner should enter the debug page via the web site https://IPaddress/
artemis-portal.
3) Enter the request URL, request parameters, and authentication information (the APPkey and
APPsecret are returned after creating partner) to start the test.
If the request URL is available, the corresponding response message will be returned.
27
Chapter 3 Protocol Summary
3.1 Request and Response Rule
3.1.1 Request
The request for executing a task contains HTTP method, request URL, and request message.
HTTP Method
The POST method is used to execute different tasks in this manual.
Request URL
The format of request URL is defined as "<protocol>://<serverAddress>[:serverPort][absolutePath?
[query]]". For example, https://10.26.31.41:443/artemis/api/example?
qa=value1&qb=value2&qc=value3.
protocol
Required, protocol type, here in this manual, it always be "https".
serverAddress
Required, domain name or IP address of the platform, i.e., "10.26.31.41" in the above URL
example.
serverPort
Optional, web access port No. of the platform, i.e., "403" in the above URL example. If this field is
not configured, it will use the default port No.
absolutePath
Required, the absolute path of resources for identifying, and it is a part of URI (Uniform Resource
Identifier), i.e., "/artemis/api/example" in the above URL example.
query
Optional, parameters for describing the resource, and it is the other part of URI (Uniform
Resource Identifier), i.e., "qa", "qb", and "qc" in the above URL example.
Note
The URI is a uniform resource identifier for distinguishing different resource types, which consists
of absolutePath and query, i.e., "/artemis/api/example?qa=value1&qb=value2&qc=value3" in the
above URL example. Sometime, the URI will replace the URL to simplify the description.
28
Request Message
The request message is in JSON format and encoded by UTF-8 rule. It consists of multiple input
parameters, and the parameters are named by camel case.
3.1.2 Response
The response returned after calling API contains response message and status or error code.
Response Message
The response message is in JSON format and encoded by UTF-8 rule. It consists of multiple output
parameters, and the parameters are named by camel case, refer to the parameter description
below.
Parameter Required/ Data Type Description

Optional
code Required String Returned status or error code: 0-succeeded,
other codes-failed (refer to Status or Error Code
for details); its maximum length is 32 bits.
msg Required String Status or error description, which is in one-to-
one correspondence with the code, refer to
Status or Error Code for details.
data Required / The data details vary in different request URLs.
Status or Error Code

The status or error code will be returned in the response message. If succeeded, the status code is
"0"; and if failed, the error codes vary in different error types, refer to Status or Error Code for
details.
Example
Response of Calling Succeeded
{
"code": "0",
"msg": "Success",
"data": {
"streamURL":"rtsp://10.2.145.66:655/EUrl/CLJ52BW"
}
}
Example
Response of Calling Failed
29
{
"code": "0x02401006",
"msg": "Token Exception.",
"data":""
}
Example
Response of Single Data Item
{
"code":"0",
"msg":"xxxxxx",
"data":{
"userId": xxxxxx,
"name": "xxxxxx",
…
}
}
Example
Response of Paged Batch Data
{
"code":"0",
"msg":"xxxxxx",
"data":{
"total":5,
"pageSize":20,
"pageNo": 1,
"list": [{
"userId": xxxxxx,
"name": "xxxxxx",
…
},
{
"userId": xxxxxx,
"name": "xxxxxx",
…
}]
}
}
Example
Response of Batch Data without Paging
{
"code":"0",
"msg":"xxxxxx",
"data":{
"total":5,
"list": [{
"userId": xxxxxx,
30
"name": "xxxxxx",
…
},
{
"userId": xxxxxx,
"name": "xxxxxx",
…
}]
}
}
3.2 Signature and Authentication

The APIs in this document use AK/SK digest authentication, the AK/SK is generated by the gateway.
Signature String
The signature string before calculating consists of HTTP method, headers, and URI, which is defined
as below.
HTTP METHOD "\n"
Accept "\n"
Content-MD5 "\n"
Content-Type "\n"
Date "\n"
Headers
Uri
HTTP METHOD
The HTTP method must be upper-case, e.g., "POST".
Accept
Setting Accept header is suggested. As for some HTTP clients, if Accept is not configured, the
default value: */* will automatically be assigned to it, which may cause the failure of signature
verification.
Content-MD5
The Content-MD5 is the value of digest calculated by MD5 algorithm in the request body and
processed by BASE64 algorithm, and the body must be on non-form format. E.g., String content-
MD5=Base64.encodeBase64(MD5(bodyStream.getbytes("UTF-8"))).
Content-Type
Content format, such as "text/plain", "text/xml", and "text/json".
Date
Signature date and time.
Headers
31
The headers consists of X-Ca-Key, X-Ca-Signature, X-Ca-Signature-Headers, X-Ca-Timestamp, X-Ca-

Nonce, and other custom headers. A value will be assigned to each header, the format is
"header:value\n", in which, the header should be in lower-case and there is no space at front and
behind of the value, also, it should end with "\n". For headers in a list, they should be sorted
alphabetically.
X-Ca-Key
Required, appKey or appSecret for authentication and it should be obtained by contacting our
technical supports.
Make sure the appKey or appSecret is properly kept. Otherwise, please reset it and get a new
one.
X-Ca-Signature
Required, signature string.
X-Ca-Signature-Headers
Required, a lower-case name string of headers that will be calculated in the signature. The
names in the string will be sorted alphabetically and each two names are separated by
comma. E.g., x-ca-signature-headers:x-ca-key,x-ca-timestamp.
Note
The following headers will not be calculated in the signature: X-Ca-Signature, X-Ca-Signature-
Headers, Accept, Content-MD5, Content-Type, Date, Content-Length, Server, Connection, Host,
Transfer-Encoding, X-Application-Context, and Content-Encoding.
X-Ca-Timestamp
Optional, time stamp of calling API, the value equals to the number of milliseconds calculated
from 00:00:00 on 1st., Jan., 1970 to the current time. E.g., x-ca-timstamp:1550153182830.
X-Ca-Nonce
Optional, UUID generated when calling API, which is used with the time stamp for anti-replay.
Uri
Uniform resource identifier, which consists of resource absolute path and query parameters, e.g.,
"/artemis/api/example?qa=value1&qb=value2&qc", or "/artemis/api/example".
Note
Each header should end with "\n", but if the Accept, Content-MD5, Content-Type, or Date header
does not exist, "\n" is not required.
The following shows the example of signature string before calculating.

POST \n
*/* \n
dGhpcyBpcyBhIGV4YW1wbGU= \n
text/plain;charset=UTF-8 \n
Thu, 24 Nov 2016 03:12:25 GMT \n
32
a-header:value \n
b-header:value \n
x-ca-key:1231243298 \n
x-ca-timestamp:1479956865000 \n
/artemis/api/example?a-bodyform=value&a-query=value&b-query=value
Signature Calculation
1. Calculate the signature string by HmacSHA256 algorithm with the appKey or appSecret to
generate message digest.
2. Calculate the message digest by BASE64 algorithm to generate the signature.
Note
During the signature calculation, the encoding format is UTF-8.
The following shows the JAVA sample code of signature calculation:

Mac hmacSha256 = Mac.getInstance("HmacSHA256");
byte[] keyBytes = secret.getBytes("UTF-8");
hmacSha256.init(new SecretKeySpec(keyBytes, 0, keyBytes.length, "HmacSHA256"));
String sign = new String(Base64.encodeBase64(Sha256.doFinal(stringToSign.getBytes("UTF-8")),"UTF-8"));
Signature Transfer and Authentication

The signature must be transmitted in the request header, see details in the sample code below.
/*request URL*/
http://www.example.com/artemis/api/example?qa=a&qb=B
/*HTTP method*/
POST
/*headers*/
Accept:*/*
Accept-Encoding:gzip, deflate, sdch
Accept-Language:en-US,en;q=0.8
Connection:keep-alive
Content-Length:0
Content-Type:text/plain;charset=UTF-8
Cookie:JSESSIONID=D9C4A515CACAC31211D1612039D062B7
header-A:A
header-B:b
X-Ca-Key:29666671
X-Ca-Signature:XeBEg2Ifh+FOfeProHLMYz8luWkJ00Exx7N7tJuats8=
X-Ca-Signature-Headers:header-a,header-b,x-ca-key,x-ca-timestamp
X-Ca-Timestamp:1479968678000
X-Requested-With:XMLHttpRequest
/*query parameters*/
qa:a
qb:B
/*signature string*/
POST\n
*/*\n
text/plain;charset=UTF-8\n
33
header-a:A\n
header-b:b\n
x-ca-key:29666671\n
x-ca-timestamp:1479968678000\n
/artemis/api/example?a-body=a&qa=a&qb=B&x-body=x
/*signature information*/
XeBEg2Ifh+FOfeProHLMYz8luWkJ00Exx7N7tJuats8=
Example
Sample Flow of Signature and Authentication
Figure 3-1 Calculate Signature and Authenticate
34
Chapter 4 Typical Applications
4.1 Manage Resources

To operate and control resource points, you must know some basic information of the resource
points. Here provides some APIs to search, manage, and get the information of different resource
points, such as encoding devices, access control device, cameras, sites, areas, vehicles, access
points, persons, organizations, and so on.
Figure 4-1 Sequence Diagram of Getting Resource Information
4.1.1 Get Physical Resources' Information

Get the information of encoding devices, access control devices, Streaming Servers, Recording
Servers, System Management Servers, and DeepinMind Servers.
35
Table 4-1 Encoding Device

Function API
Get encoding device list POST /artemis/api/resource/v1/encodeDevice/
encodeDeviceList
Get an encoding device's POST /artemis/api/resource/v1/encodeDevice/indexCode/
information encodeDeviceInfo
Search for encoding devices by POST /artemis/api/resource/v1/encodeDevice/advance/
condition encodeDeviceList
Table 4-2 Access Control Device

Function API
Get access control device list POST /artemis/api/resource/v1/acsDevice/acsDeviceList
Get an access control device's POST /artemis/api/resource/v1/acsDevice/indexCode/
information acsDeviceInfo
Search for access control POST /artemis/api/resource/v1/acsDevice/advance/
devices by condition acsDeviceList
Table 4-3 Streaming Server

Function API
Get Streaming Server list POST /artemis/api/resource/v1/streamServer/
streamServerList
Table 4-4 Recording Server

Function API
Get Recording Server list POST /artemis/api/resource/v1/recordServer/recordServerList
Get information of a Recording POST /artemis/api/resource/v1/recordServer/indexCode/
Server recordServerInfo
Get storage status of cameras POST /artemis/api/resource/v1/recordServer/recordStatus
linked to a specific Recording
Server
36
Table 4-5 System Management Server

Function API
Get information of the System POST /artemis/api/resource/v1/videoManagementServer
Management Server
Table 4-6 DeepinMind Server

Function API
Get DeepinMind Server list POST /artemis/api/resource/v1/intelligentServer/
intelligentServerList
Table 4-7 On-Board Device

Function API
Get the on-board device list in POST /artemis/api/resource/v1/mobileDevice/
page mobileDeviceList
Get the information of an on- POST /artemis/api/resource/v1/mobileDevice/indexCode/
board device by device ID mobileDeviceInfo
Search the on-board device list POST /artemis/api/resource/v1/mobileDevice/advance/
mobileDeviceList
4.1.2 Get Logical Resources' Information

You can get the information of sites, areas, cameras, organizations, access points, vehicles,
persons, face comparison groups, faces, alarm inputs/outputs, and visitors.
Table 4-8 Site

Function API
Get site list POST /artemis/api/resource/v1/site/siteList
Get a site's information POST /artemis/api/resource/v1/site/indexCode/siteInfo
Search for sites by condition POST /artemis/api/resource/v1/site/advance/siteList
37
Table 4-9 Area

Function API
Get area list of a parent area by POST /artemis/api/resource/v1/regions/subRegions
area No.
Get an area's information by POST /artemis/api/resource/v1/region/indexCode/regionInfo
area No.
Search for areas by condition POST /artemis/api/resource/v1/regions
Table 4-10 Camera

Function API
Get camera list of an area by POST /artemis/api/resource/v1/cameras
area No.
Get a camera's information by POST /artemis/api/resource/v1/cameras/indexCode
camera ID
Get cameras' information in POST /artemis/api/resource/v1/cameras
page
Search for cameras by POST /artemis/api/resource/v1/camera/advance/cameraList
condition
Table 4-11 Organization

Function Description
Get root organization POST /artemis/api/resource/v1/org/rootOrg
information
Get information list of lower- POST /artemis/api/resource/v1/org/parentOrgIndexCode/
level organizations by parent subOrgList
organization
Get information of an POST /artemis/api/resource/v1/org/orgIndexCode/orgInfo
organization
Get information list of all POST /artemis/api/resource/v1/org/orgList
organizations
Search for organizations by POST /artemis/api/resource/v1/org/advance/orgList
condition
Add an organization POST /artemis/api/resource/v1/org/single/add
38
Edit an organization's POST /artemis/api/resource/v1/org/single/update
information
Delete an organization POST /artemis/api/resource/v1/org/single/delete
Table 4-12 Access Point

Function API
Get access point list of an area POST /artemis/api/resource/v1/acsDoor/region/acsDoorList
by area No.
Get an access point's POST /artemis/api/resource/v1/acsDoor/indexCode/
information acsDoorInfo
Get access points' information POST /artemis/api/resource/v1/acsDoor/acsDoorList
in page
Search for access points by POST /artemis/api/resource/v1/acsDoor/advance/acsDoorList
condition
Get card reader information POST /artemis/api/resource/v1/reader/search
Table 4-13 Vehicle

Function API
Get vehicle group list POST /artemis/api/resource/v1/vehicleGroup/vehicleGroupList
Add a vehicle group POST /artemis/api/resource/v1/vehicleGroup/single/add
Edit a vehicle group's POST /artemis/api/resource/v1/vehicleGroup/single/update
information
Delete a vehicle group POST /artemis/api/resource/v1/vehicleGroup/single/delete
Get vehicle list POST /artemis/api/resource/v1/vehicle/vehicleList
Add a vehicle POST /artemis/api/resource/v1/vehicle/single/add
Edit a vehicle's information POST /artemis/api/resource/v1/vehicle/single/update
Delete a vehicle POST /artemis/api/resource/v1/vehicle/single/delete
Get a vehicle's information by POST /artemis/api/resource/v1/vehicle/indexCode/vehicleInfo
vehicle ID
Search for vehicles by condition POST /artemis/api/resource/v1/vehicle/advance/vehicleList
39
Table 4-14 Vehicle Linked to On-Board Device

Get the list of vehicles linked to POST /artemis/api/resource/v1/mobilevehicle/
on-board devices mobilevehicleList
Get the information of a POST /artemis/api/resource/v1/mobileVehicle/indexCode/
vehicle linked to the on-board mobileVehicleInfo
device
Search the list of vehicles POST /artemis/api/resource/v1/mobilevehicle/advanced/
linked to on-board devices mobilevehicleList
Table 4-15 Person

Function API
Get persons' information POST /artemis/api/resource/v1/person/personList
Get a person's information by POST /artemis/api/resource/v1/person/personId/personInfo
person ID
Search for persons by condition POST /artemis/api/resource/v1/person/advance/personList
Get person picture POST /artemis/api/resource/v1/person/picture_data
Add a person POST /artemis/api/resource/v1/person/single/add
Edit a person's information POST /artemis/api/resource/v1/person/single/update
Delete a person POST /artemis/api/resource/v1/person/single/delete
Edit information of face linked POST /artemis/api/resource/v1/person/face/update
with person
Edit information of fingerprint POST /artemis/api/resource/v1/person/fingerPrints/update
linked with person
Get person information POST /artemis/api/resource/v1/person/personCode/
according to person ID personInfo
Get the person's custom POST /artemis/api/resource/v1/person/customFields
information
Edit the person's custom POST /artemis/api/resource/v1/person/personId/
information customFieldsUpdate
Verify the validity of face POST /artemis/api/acs/v1/faceCheck
picture
40
Table 4-16 Face Comparison Group

Get information list of face POST /artemis/api/frs/v1/face/groupList
comparison groups
Search for face comparison POST /artemis/api/frs/v1/face/group
groups
Add a face comparison group POST /artemis/api/frs/v1/face/group/single/addition
Edit information of a face POST /artemis/api/frs/v1/face/group/single/update
comparison group
Delete a face comparison POST /artemis/api/frs/v1/face/group/batch/deletion
group
Apply face comparison group POST /artemis/api/frs/v1/plan/recognition/black/restart
to device
Search for the face comparison POST /artemis/api/aiapplication/v1/face/faceMatchRecord
information by camera
Table 4-17 Face

Add a face's information POST /artemis/api/frs/v1/face/single/addition
Delete a face's information POST /artemis/api/frs/v1/face/deletion
Search for face information in POST /artemis/api/frs/v1/face
face comparison group
Download face picture via URL POST /artemis/api/frs/v1/application/picture
Table 4-18 Alarm Input/Output

Get alarm input information POST /artemis/api/resource/v1/alarmInputs/indexCode
according to alarm input ID
Get all the alarm input POST /artemis/api/resource/v1/alarmInputs
information
Search for alarm input POST /artemis/api/resource/v1/alarmInput/advance/
information alarmInputList
41
Get alarm output information POST /artemis/api/resource/v1/alarmOutputs/indexCode
according to alarm output ID
Get all the alarm output POST /artemis/api/resource/v1/alarmOutputs
information
Search for alarm output POST /artemis/api/resource/v1/alarmOutput/advance/
information alarmOutputList
Control alarm output POST /artemis/api/resource/v1/alarmOutput/controlling
Table 4-19 Visitor

Add a visitor's reservation POST /artemis/api/visitor/v1/appointment
record
Add a visitor's reservation POST /artemis/api/visitor/v2/appointment
record (v2)
Edit a visitor's reservation POST /artemis/api/visitor/v1/appointment/update
record
Edit a visitor's reservation POST /artemis/api/visitor/v2/appointment/update
record (v2)
Delete a visitor's reservation POST /artemis/api/visitor/v1/appointment/single/delete
record
Get the list of the reservation POST /artemis/api/visitor/v1/appointment/appointmentlist
records
Get the picture of a visitor POST /artemis/api/visitor/v1/appointment/downloadpicture
Add a visitor's information for POST /artemis/api/visitor/v1/registerment
checking in
Edit a visitor's information for POST /artemis/api/visitor/v1/registerment/update
checking in
Revoke visitor's permission POST /artemis/api/visitor/v1/visitor/out
after he/she checks out
Verify the validity of face POST /artemis/api/acs/v1/faceCheck
picture
Search for the custom POST /artemis/api/visitor/v1/visitorconfig/customfields
information about visitors
42
Search for the information POST /artemis/api/visitor/v1/visitorgroups
about visitor groups by group
name
Search for visitors' information POST /artemis/api/visitor/v1/visitorgroups/groupinfo
by visitor group ID
Get the visitor's information by POST /artemis/api/visitor/v1/visitor/visitorInfo
condition
Get the information about a POST /artemis/api/visitor/v1/visitor/single/visitorinfo
single visitor
4.2 Get Video and Audio Stream

You can get the video and audio stream, and download playback videos via standard RTSP, but
cannot play the video or audio on the OpenAPI platform. Therefore, you must develop a player via
the APIs provided by C++ or C# language SDK, develop a video plug-in on web browser, or adopt
the non plug-in solution of JsDecoder to start live view, playback, or two-way audio in Windows
operating system.
43
Figure 4-2 Video Application Development
Note
The C++ or C# language SDK, web plug-in, and JsDecoder only supports Windows operating system.
And the SDK can implement the functions of live view, playback, PTZ control, capturing, stream
callback, and so on, while the web plug-in and JsDecoder only provide live view and playback
functions. Refer to the HikCentral Professional Video SDK (C++) Developer Guide, HikCentral
Professional Video SDK (C#) Demo User Manual, HikCentral Professional Video WebSDK Developer
Guide, and HikCentral Professional Video JsDecoder SDK_Developer Guide for details.
44
Live View
Figure 4-3 Sequence Diagram of Getting Live View Stream
Note
Refer to POST /artemis/api/video/v1/cameras/previewURLs and POST /artemis/api/video/v2/
cameras/previewURLs for details.
Playback
Figure 4-4 Sequence Diagram of Getting Playback Stream
45
Note
Refer to POST /artemis/api/video/v1/cameras/playbackURLs for details.
Two-Way Audio
Figure 4-5 Sequence Diagram of Getting Two-Way Audio Stream
Note
Refer to POST /artemis/api/video/v1/cameras/talkURLs and POST /artemis/api/video/v1/
device/talkURLs for details.
46
Download Playback Recording
Figure 4-6 API Calling Flow of Downloading Playback Recording

1. Get the alarm time or time with a person/vehicle detection tag.
2. Call POST /artemis/api/video/v1/cameras/playbackURLs to get the streaming URL for
playback.
3. Call POST /artemis/api/video/v1/download to download recordings by obtained playback URL
and returned information.
4. Call POST /artemis/api/video/v1/downloadURL to get the download progress and download
URL.
47
4.3 Control PTZ

After adding cameras and start live view in HikCentral Professional, you can call the APIs provided
here to control PTZ, manage presets and patrols.
PTZ Control
Call API POST /artemis/api/video/v1/ptzs/controlling .
Preset
Function API
Search for presets POST /artemis/api/video/v1/presets/searches
Add presets POST /artemis/api/video/v1/presets/addition
Delete presets POST /artemis/api/video/v1/presets/deletion
Patrol
Function API
Search for patrols POST /artemis/api/video/v1/patrols/searches
Add patrols POST /artemis/api/video/v1/patrols/addition
Delete patrols POST /artemis/api/video/v1/patrols/deletion
Get presets' information of a POST /artemis/api/video/v1/patrols/patrolIndex/patrolInfo
patrol by patrol No.
4.4 Configure Generic Event

Generic event is the signal that resource (e.g., other software, device) sends when something
occurs, and can be received in the form of TCP or UDP data packages, which the system can
analyze and generate events if they match configured expression. You can customize the
expression to create a generic event to analyze the received TCP and/or UDP data packages, and
trigger events when specified conditions are met. In this way, you can easily integrate your system
with a very wide range of external sources, such as access control systems and alarm systems.
48
Steps
Figure 4-7 API Calling Flow of Configuring Generic Event

1. Call POST /artemis/api/eventService/v1/generalEventRule/single/add to customize the
expression to add a generic event.
2. Call POST /artemis/api/eventService/v1/generalEventRule/generalEventRuleList to get the
configured generic events.
3. Optional: Perform the following operation(s) after adding a generic event.
Edit a generic event POST /artemis/api/eventService/v1/generalEventRule/single/
update
Delete a generic event POST /artemis/api/eventService/v1/generalEventRule/single/
delete
4. Call POST /artemis/api/eventService/v1/generalEventRule/triggerAlarm to enable receiving
generic events.
5. Optional: When event is triggered, receive the generic event information on the Control Client.
4.5 Receive Alarm or Event

Event is a signal that resource (e.g., camera, device, server) sends when something occurs, while
alarm is used to notify security personnel of the particular situation which helps handle the
situation promptly. To receive alarm or event information, you should first subscribe the event
types or alarm categories. When the subscribed type or category of event occurred or alarm is
triggered, the platform or service will automatically upload the related information to the caller for
processing or acknowledgment.
49
Steps
Figure 4-8 API Calling Flow of Receiving Alarm or Event

1. Enable HTTP or HTTPS service.
2. Call POST /artemis/api/eventService/v1/eventSubscriptionByEventTypes to set event type or
alarm category to subscribe.
Note
Multiple event types or alarm categories are available to be subscribed, refer to Event Types or
Alarm Categories for details.
3. Optional: Call POST /artemis/api/eventService/v1/eventSubscriptionView to search for the
subscription details of a user.
4. Optional: Call POST /artemis/api/eventService/v1/eventUnSubscriptionByEventTypes to
specify the event types or alarm categories to cancel subscribing.
5. Receive alarm or event information when alarm is triggered or event occurred.
6. Optional: Call POST /artemis/api/eventService/v1/eventRecords/controlling to acknowledge
the alarm.
Note
The alarm or event receiving and alarm acknowledgment must be in different threads.
50
4.6 Search for Events and Get Picture

You can search for the received alarms or events by some specific search conditions, such as event
type, event source type, start or end time, and so on. If there are pictures contained in the search
results, you can get the picture URLs to download the pictures.
Before You Start
Make sure you have subscribed and received the alarms or events.
Steps
Figure 4-9 API Calling Flow of Searching for Events and Getting Pictures
1. Get related resources information, including cameras, encoding device, and access points, refer
to Manage Resources for details.
2. Perform one of the following operations to search for alarm records, vehicle passing records,
and card swiping records.
- Call POST /artemis/api/eventService/v1/eventRecords/page to search for alarm records.
- Call POST /artemis/api/pms/v1/crossRecords/page to search for vehicle passing records.
- Call POST /artemis/api/acs/v1/door/events to search for card swiping records.
3. Optional: Get the picture URL from the searched events and perform one of the following
operations to download the alarm picture, vehicle passing picture, and access control event
picture.
51
- Call POST /artemis/api/eventService/v1/image_data to download the alarm picture

according to the obtained picture URL.
- Call POST /artemis/api/pms/v1/image_data to download the vehicle passing picture
- Call POST /artemis/api/acs/v1/event/pictures to download access control event picture
4.7 Manage Person's Access Level

In access control, access level is a group of doors and floors. After assigning the access level to
certain persons, it defines the access permission that which persons can get access to which doors
and floors during the authorized time period. After setting the linkage between access levels and
persons, you should apply the persons' access level settings to device to take effect.
Before You Start
● Make sure you have added access levels on the platform. Refer to the User Manual of HikCentral
Professional Web Client for details.

● Make sure you have add persons. Refer to Table 4-15 for details.
52
Steps
Figure 4-10 API Calling Flow of Managing Person's Access Level
Note
Currently, the parameters of managing persons' access levels must be configured on HikCentral
Professional. That is, before managing access levels or applying persons' access level settings to
device, you must add persons, add access levels, create access group, and link person group with
access group on the platform.
1. Optional: Call POST /artemis/api/acs/v1/privilege/group to get the existing access levels for
reference.
2. Optional: Call POST /artemis/api/acs/v1/privilege/group/single/personList to get the persons
related to the access levels for reference.
53
3. Call POST /artemis/api/acs/v1/privilege/group/single/addPersons to assign access levels to

the persons.
Note
You can also assign access levels to persons on the platform. Refer to the User Manual of
HikCentral Professional Web Client for details.
4. Optional: Call POST /artemis/api/acs/v1/privilege/group/single/deletePersons to unassign
access levels to persons.
5. Call POST /artemis/api/visitor/v1/auth/reapplication to apply persons' access level settings to
device.
6. Optional: Call POST /artemis/api/acs/v1/auth/applicationResult to get the details of access
level applying.
4.8 Control Door Status

You can control the status for a single door, including opening door, closing door, remaining the
door open, and remaining the door closed.
Steps
Figure 4-11 API Calling Flow of Controlling Door Status

1. Get door (access point) information, refer to Manage Resources for details.
2. Call POST /artemis/api/acs/v1/door/doControl to control the status of a single door.
4.9 Manage Vehicle Parking

You can manage the vehicles in the parking lots, including searching for vehicle passing records,
getting the real-time occupancy of parking spaces, and searching for vehicle parking records.
54
Search for Vehicle Passing Records
Figure 4-12 API Calling Flow of Searching for Vehicle Passing Records
1. Call POST /artemis/api/vehicle/v1/parkinglot/list to get the parking lot list.
2. Call POST /artemis/api/vehicle/v1/parkinglot/passageway/record to search for the vehicle
passing records of the specified parking lot.
3. (Optional) Call POST /artemis/api/pms/v1/image_data to download the vehicle pictures via
the URLs in the records.
55
Get the Real-Time Occupancy of the Parking Spaces
Figure 4-13 API Calling Flow of Getting the Real-Time Occupancy of the Parking Spaces
2. Call POST /artemis/api/vehicle/v1/floor/list to get the floor list of the specified parking lots.
3. Call POST /artemis/api/vehicle/v1/floor/overview to get the occupancy of the specified floors.
4. Call POST /artemis/api/vehicle/v1/floor/parkingspace/status to get the real-time status of all
parking spaces on the specified floor.
56
Search for the Vehicle Parking Records
Figure 4-14 API Calling Flow of Searching for the Vehicle Parking Records
2. Call POST /artemis/api/vehicle/v1/floor/list to get the floor list of the specified parking lots.
3. Call POST /artemis/api/vehicle/v1/parkingspace/record to get the vehicle parking records.
57
Get the Vehicle Parking Fee Information
Figure 4-15 API Calling Flow of Getting the Vehicle Parking Fee Information
Enter the license plate number and call POST /artemis/api/vehicle/v1/parkingfee/calculate to get
the parking fee information of the vehicle in the current parking lot.
58
Confirm the Payment of Parking Fee and Allow Exit
Figure 4-16 API Calling Flow of Confirming the Payment of Parking Fee and Allow Exit
Enter the license plate number and call POST /artemis/api/vehicle/v1/parkingfee/confirm .
● Payment on exit:
○ If the vehicle is right at the barrier gate, the gate will be opened once the payment is made via
booth.
○ If the vehicle is not at the barrier gate, a pompt on absence will be be sent.
● Payment before exit:
○ If the vehicle is to exit wthin the paid duration, the gate will be automatically opened on exit.
○ If the vehicle is to exit after the paid duration, extra time will be charged and the gate will be
automatically opened after the payment is made.
Manage Vehicle Information in the Bolcklist

● Call POST /artemis/api/vehicle/v1/vehicle/blocklist/add to add a vehicle to the blocklist.
● Call POST /artemis/api/vehicle/v1/vehicle/blocklist/delete to delete the vehicle from the
blocklist.
● Call POST /artemis/api/vehicle/v1/vehicle/blocklist/modify to edit the vehicle in the blocklist..
● Call POST /artemis/api/vehicle/v1/vehicle/blocklist/get to search the vehicle blocklist.
59
4.10 Manage Visitors

You can manage visitors, including making reservations for visitors, checking in visitors with/
without reservation information, and checking out visitors.
Make a Reservation
Call POST /artemis/api/visitor/v2/appointment to make a reservation for a visitor.
Note
A reservation record ID will be returned, which is used for checking in.
Check in a Visitor Without Reservation
Figure 4-17 API Calling Flow of Checking in a Visitor Without Reservation

1. Call POST /artemis/api/visitor/v1/registerment to check in a visitor without reservation.
2. Call POST /artemis/api/acs/v1/privilege/group to get the access level list.
the visitor.
4. Call POST /artemis/api/visitor/v1/auth/reapplication to apply the visitor's access level settings
to devices.
60
Check in a Visitor with Reservation Information
Figure 4-18 API Calling Flow of Checking in a Visitor with Reservation Information
1. Call POST /artemis/api/visitor/v1/appointment/appointmentlist to get the reservation record.
2. Call POST /artemis/api/visitor/v1/registerment to check in a visitor.
3. Call POST /artemis/api/acs/v1/privilege/group to get the access level list.
the visitor.
5. Call POST /artemis/api/visitor/v1/auth/reapplication to apply the visitor's access level settings
to devices.
61
Check out a Visitor

Call POST /artemis/api/visitor/v1/visitor/out to check out a visitor and the visitor's access
permission will be revoked.
Search Visitor Access Records
● Call POST /artemis/api/visitor/v1/appointment/appointmentlist to get the reservation record
list.
● Call POST /artemis/api/visitor/v1/visitorgroups/groupinfo to search for visitors' information by
visitor group ID.
● Call POST /artemis/api/visitor/v1/visitor/visitorInfo to search for visitors' information by
condition.
4.11 Manage On-Board Monitoring

Get detailed information of GPS statistics, search for event information of an on-board device, and
search for event records of vehicles linked to on-board devices (only including the brief
information).
Search for Driving Event Records

You can search for records of driving events of the following types.
● On-Board module event: panic button alarm, sharp turn, sudden brake, sudden acceleration,
rollover, overspeed, collision, enter fence, deviation, and exit fence.

● Driver behavior event: smoking, on the phone, fatigue driving, distracted, not buckled up, and
video tampering.
● ADAS event: front vehicle collision warning, short vehicle distance warning, lane deviation
warning, pedestrian collision warning, overspeed warning, and blind spot detection warning.
62
Figure 4-19 API Calling Flow of Searching for Driving Event Records
1. Call POST /artemis/api/resource/v1/mobilevehicle/mobilevehicleList to get the list of vehicles
linked to on-board devices.
2. Call Events of Vehicles Linked to On-Board Devices to search for event types of vehicles linked
to on-board devices.
3. Call POST /artemis/api/mobilesurveillance/v1/recordOverview to search for event records of
vehicles linked to on-board devices.
4. Call POST /artemis/api/mobilesurveillance/v1/single/record to search for event information of
an on-board device.
63
Search for GPS Statistics
Figure 4-20 API Calling Flow of Searching for GPS Statistics

1. Call POST /artemis/api/resource/v1/mobilevehicle/mobilevehicleList to get the list of vehicles
linked to on-board devices.
2. Call POST /artemis/api/mobilesurveillance/v1/gpsdetails to get GPS statistics information of
on-board devices.
Receive Events of Vehicles Linked to On-Board Devices

You can receive real-time event notifications with relevant subscription. Refer to Receive Alarm or
Event for details.
64
Get People Counting Statistics of Vehicle Linked to On-Board Device

You can create a people counting analysis group via on-board device to get the real-time people
counting statistics, i.e., the number of people on the vehicle.
Figure 4-21 API Calling Flow of Getting People Counting Statistics of Vehicle Linked to On-Board
Device
1. Call POST /artemis/api/aiapplication/v1/people/advance/resourceGroupList to get the list of
resource groups.
2. Call POST /artemis/api/aiapplication/v1/people/resourceGroupRealTimeCount to get the real-
time statistics of resource groups.
65
4.12 Search for Person

You can search for person by searching for matched faces / human bodies on Intelligent Fusion
Server.
Search for Matched Faces
Figure 4-22 API Calling Flow of Searching for Matched Faces

1. Call the Base64 converter to get the picture data.
2. Call POST /artemis/api/frs/v1/application/pictureRecognitionModel to detect and model
faces in the picture.
66
3. Call POST /artemis/api/frs/v1/application/captureSearch to get matched faces by face picture

comparison according to the face modeling data.
4. Call POST /artemis/api/frs/v1/application/picture to download the target picture according
the returned URL and convert it by Base64.
Search for Matched Human Bodies
Figure 4-23 API Calling Flow of Searching for Matched Human Bodies
1. Call the Base64 converter to get the picture data.
2. Call POST /artemis/api/body/v1/application/pictureRecognition to detect human body and
get the human body coordinates.
3. Call POST /artemis/api/body/v1/application/pictureModel to get the human body modeling
data according to the coordinates.
67
4. Call POST /artemis/api/body/v1/application/captureSearch to get matched human bodies by

body picture comparison according to the modeling data, and get the target picture
information.
5. Call POST /artemis/api/frs/v1/application/picture to download the target picture according to
the returned URL and convert it by Base 64.
4.13 Manage Digital Signage

You can upload dynamic materials of third part data source, link them to a program, and push data
by updating the data source.
Figure 4-24 API Calling Flow of Managing Data Source

1. (Optional) Call POST /artemis/api/focsign/v1/material/dataSource/search to search for the
data source.
2. Call POST /artemis/api/focsign/v1/material/dataSource/update / POST /artemis/api/
focsign/v1/material/dataSource/update/batch to update / batch update the data source.
68
Chapter 5 API Reference
5.1 Common API

Here provides an API for getting version information.
5.1.1 POST /artemis/api/common/v1/version

Get version information of platform.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/common/v1/version
Request Parameters
Parameter Req. or Opt. Data Type Parameter Description

Type
userId Opt. String Header User ID, which consists of 1 to
32 characters, but cannot
contain special characters like
'/\:*?"<>|
Response Parameters
Parameter Req. or Opt. Data Type Description

code Req. String Response status or error code: 0-
succeeded, other codes-failed (refer
to Status or Error Code for details).
Each code can contain up to 32
characters.
msg Req. String Status or error description, which is in
one-to-one correspondence with the
code, refer to Status or Error Code for
details. Each description can contain
up to 256 characters.
data Req. Object Version information. See details in
Version .
69
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"produceName": "HikCentral Professional",
"softVersion": "V2.1.0.0"
}
}
5.2 Physical Resources API

Here provides APIs for the management of encoding devices, access control devices, Streaming
Servers, Recording Servers, DeepinMind Servers, and System Management Servers.
5.2.1 POST /artemis/api/resource/v1/acsDevice/acsDeviceList

Get the information list of all access control devices, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDevice/acsDeviceList
Request Parameters

Type
'/\:*?"<>|
pageNo Req. Number Body The current page No., which is
between 1 and 2147483647.
pageSize Req. Number Body Number of records on each
page, which is between 1 and
500.
Request Example
{
"pageNo": 1,
70
"pageSize": 2
}
Response Parameters

characters.
data Opt. Object Response data details.
total Opt. Number Total number of search results.
pageNo Opt. Number The current page No.
pageSize Opt. Number Number of records on each page.
list Opt. Array List of access control device
information.
list[0] Opt. Object Information of an access control
device in the list. See details in
AcsDevInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 4,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"acsDevIndexCode": "46",
"acsDevName": "10.18.64.39",
"acsDevIp": "10.18.64.39",
"acsDevPort": "9502",
"treatyType": "hiksdk_net",
71
"acsDevCode": "DS-K1T671TM-3XF20210308V030202ENE43116796",
"status ": 2
},
{
"acsDevName": "10.18.66.112",
"acsDevIp": "10.18.66.112",
"acsDevCode": "DS-K1T680MF-E120210303V030203ENE33392121",
"status ": 2
}
]
}
}
5.2.2 POST /artemis/api/resource/v1/acsDevice/advance/acsDeviceList

Set search condition (i.e., device name) to search the specified access control devices, and fuzzy
search is supported; if the search condition is not configured, the information of all access control
devices will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDevice/advance/acsDeviceList
Request Parameters

Type
'/\:*?"<>|
500.
acsDevName Opt. String Body Access control device name,
which consists of 1 to 32
characters, but cannot contain
72

Type
special characters like ' / \ : * ?
"<>|
Request Example
{
"pageNo": 1,
"pageSize": 10，
"acsDevName": "10.18.64.39"
}
Response Parameters

characters.
list Opt. Array Information list of access control
devices.
list[0] Opt. Object Information of an access control
device in the list. See details in
AcsDevInfo .
73
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"acsDevName": "10.18.64.39",
"acsDevIp": "10.18.64.39",
"status ": 2
}
]
}
}
5.2.3 POST /artemis/api/resource/v1/acsDevice/indexCode/acsDeviceInfo

Get the information of an access control device by device ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDevice/indexCode/acsDeviceInfo
Request Parameters

Type
'/\:*?"<>|
acsDevIndexC Req. String Body Access control device ID, which
ode consists of up to 64 characters.
74
Request Example
{
"acsDevIndexCode": "46"
}
Response Parameters

characters.
data Opt. Object Access control device information.
See details in AcsDevInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"acsDevName": "10.18.64.39",
"acsDevIp": "10.18.64.39",
"status": 2
}
}
5.2.4 POST /artemis/api/resource/v1/encodeDevice/advance/encodeDeviceList

Set search condition (i.e., device name) to search the specified encoding devices, and fuzzy search
is supported; if the search condition is not configured, the information of all encoding devices will
be returned by page.
75
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/encodeDevice/advance/
encodeDeviceList
Request Parameters

Type
'/\:*?"<>|
500.
encodeDevNa Opt. String Body Encoding device name, which
me consists of 1 to 32 characters,
but cannot contain special
characters like ' / \ : * ? " < > |
Request Example
{
"pageNo": 1,
"pageSize": 10，
"encodeDevName": "10.18.66.25",
}
Response Parameters

characters.
76

list Opt. Array Encoding device information list.
list[0] Opt. Object Information of an encoding device in
the list. See details in EncodeDevInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"encodeDevIndexCode": "85",
"encodeDevIp": "10.18.66.25",
"encodeDevPort": "9000",
"encodeDevCode": "SimulatorDevice",
"status ": 2
}
]
}
}
5.2.5 POST /artemis/api/resource/v1/encodeDevice/encodeDeviceList

Get the information list of all encoding devices, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/encodeDevice/encodeDeviceList
77
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
78

list Opt. Array Encoding device information list.
list[0] Opt. Object Information of an encoding device in
the list. See details in EncodeDevInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 19,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"encodeDevName": "10.41.13.38_ ",
"encodeDevIp": "10.41.13.38",
"encodeDevCode": "DS-9632NI-I81620210322CCRRF71031387WCVU",
"status ": 1
},
{
"encodeDevIp": "10.18.66.25",
"status ": 2
}
]
}
}
5.2.6 POST /artemis/api/resource/v1/encodeDevice/indexCode/encodeDeviceInfo

Get the information of an encoding device by device ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/encodeDevice/indexCode/
encodeDeviceInfo
79
Request Parameters

Type
'/\:*?"<>|
encodeDevInd Req. String Body Encoding device ID, which
exCode consists of up to 64 characters.
Request Example
{
"encodeDevIndexCode": "85"
}
Response Parameters

characters.
data Opt. Object Encoding device information. See
details in EncodeDevInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"encodeDevIp": "10.18.66.25",
80
"status": 2
}
}
5.2.7 POST /artemis/api/resource/v1/intelligentServer/intelligentServerList

Get DeepinMind Server list to sychronize all device information. The information of all servers will
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/intelligentServer/
intelligentServerList
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
81
Response Parameters

code Req. String Returned status or error code: 0-
characters.
list Opt. Array Information list of DeepinMind
Servers.
list[0] Opt. Object Information of a DeepinMind Server,
refer to IntelligentServerInfo for
details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 4,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"intelligentServerIndexCode": "1",
"intelligentServerName": "10.41.7.96",
"intelligentServerIp": "10.41.7.96",
"status": 1
},
{
"intelligentServerName": "10.19.167.130",
82
"intelligentServerIp": "10.19.167.130",
"status": 0
}
]
}
}
5.2.8 POST /artemis/api/resource/v1/mobileDevice/mobileDeviceList

Get the on-board device list in page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobileDevice/mobileDeviceList
Request Parameters

Type
userId Opt. String Header User ID, which consists of
up to 32 characters, but
cannot contain special
characters like ' / \ : * ? " <
>|
pageNo Req. Number Body The current page No.,
which is between 1 and
2147483647.
pageSize Req. Number Body Number of records on
each page, which is
between 1 and 500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
83
Response Parameters

characters.
data Req. PageInfo Response data details.
PageInfo Object Description
Parameter Name Req. or Opt. Data Type Description

list Opt. MobileDeviceInfo On-board device list.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"mobileDevIndexCode": "1",
"mobileDevName": "10.18.66.164",
"mobileDevIp": "",
"mobileDevPort": "0",
"mobileDevCode": "20210225WRF58663372",
"treatyType": "ehome_reg",
"status ": 2
}
84
]
}
}
5.2.9 POST /artemis/api/resource/v1/mobileDevice/indexCode/mobileDeviceInfo

Get the information of an on-board device by device ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobileDevice/indexCode/
mobileDeviceInfo
Request Parameters

Type
up to to 32 characters, but
>|
mobileDevI Req. String Body On-board device ID. The
ndexCode maximum length is 64
characters.
Request Example
{
"mobileDevIndexCode ":"1"
}
Response Parameters

characters.
85

data Req. MobileDevInfo Response data details. See details in
MobileDeviceInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"mobileDevIp": "",
"status": 2
}
}
5.2.10 POST /artemis/api/resource/v1/mobileDevice/advance/mobileDeviceList

Search the on-board device list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobileDevice/advance/
mobileDeviceList
Request Parameters

Type
86

Type
>|
2147483647.
each page, which is
between 1 and 500.
mobileDevN Opt. String Body On-board device resource
ame name. The maximum
length is 128 characters.
Request Example
{
"pageNo": 1,
"pageSize": 2,
"mobileDevName": "10.18.64.39"
}
Response Parameters

characters.
87

list Opt. MobileDevInfo[] On-board device list. See details in
MobileDeviceInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"mobileDevIp": "",
"status ": 2
}
]
}
}
5.2.11 POST /artemis/api/resource/v1/recordServer/indexCode/recordServerInfo

Get information of a Recording Server by server ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/recordServer/indexCode/
recordServerInfo
88
Request Parameters

Type
'/\:*?"<>|
recordServerIn Req. String Body Recording Server ID, which
dexCode consists of up to 10 characters.
Request Example
{
"recordServerIndexCode": "1"
}
Response Parameters

characters.
data Opt. Object Information of a Recording Server,
refer to RecordServerInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"recordServerIndexCode": "1",
"recordServerName": "10.41.7.232",
"recordServerIp": "10.41.7.232",
89
"recordingStatus": 2,
"networkStatus": 1,
"hddList": [
{
"poolID": "0",
"poolName": "RV_1",
"Capacity": 821568,
"FreeSpace": 712317,
"UsedSpace": 109251
},
{
"poolID": "1",
"poolName": "PIC_RV_1",
"Capacity": 9310,
"FreeSpace": 9310,
"UsedSpace": 0
}
]
}
}
5.2.12 POST /artemis/api/resource/v1/recordServer/recordServerList

Get Recording Server list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/recordServer/recordServerList
Request Parameters

Type
'/\:*?"<>|
500.
90
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
list Opt. Array Information list of Recording Servers.
list[0] Opt. Object Information of a Recording Server,
refer to RecordServerInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 2,
"list": [
{
91
"networkStatus": 1
},
{
"networkStatus": 2
}
]
}
}
5.2.13 POST /artemis/api/resource/v1/recordServer/recordStatus

Get the storage status of cameras linked to a specific Recording Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/recordServer/recordStatus
Request Parameters

Type
' / \ : * ? " < > |.
500.
recordServerIn Req. String Body Recording Server ID, which
dexCode consists of up to 64 characters.
poolID Req. String Body Resource pool ID, which
consists of up to 32 characters.
Request Example
{
"pageNo": 1,
92
"pageSize": 2，
"poolID": "0"
}
Response Parameters

characters.
recordServerInde Opt. String Recording Server ID, which consists of
xCode up to 64 characters.
recordServerNam Opt. String Recording Server name, which
e consists of up to 64 characters.
list Opt. Array Information list of Recording Servers.
recordServerIp Opt. String IP address of Recording Server, whose
maximum length is 64 bytes.
recordingStatus Opt. Number Video status: 0-unknown, 1-normal,
2-exception.
networkStatus Opt. Number Network status: 0-unknown, 1-online,
2-offline.
total Opt. Number Total number of data records.
93

list Opt. Array Storage status list of cameras linked to
a Recording Server.
list[0] Opt. Object Storage status of a camera linked to a
Recording server, refer to
CameraRecordStatus for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"networkStatus": 1,
"list": [
{
"regionName": "10.18.65.98",
"deviceIp": "10.18.65.98",
"cameraName": "Camera 01",
"cameraIndexCode": "103",
"networkStatus": 2,
"recordingScheduleName": "",
"siteName": "HikCentral Professional",
"storageType": 1
}
]
}
}
5.2.14 POST /artemis/api/resource/v1/streamServer/streamServerList

Get Streaming Service list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/streamServer/streamServerList
94
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
95

list Opt. Array Information list of Streaming Servers.
list[0] Opt. Object Information of a Streaming Server,
refer to StreamServerInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 4,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"acsDevName": "10.18.64.39",
"acsDevIp": "10.18.64.39",
"status ": 2
},
{
"acsDevName": "10.18.66.112",
"acsDevIp": "10.18.66.112",
"acsDevCode": "DS-K1T680MF-E120210303V030203ENE33392121",
"status ": 2
}
]
}
}
5.2.15 POST /artemis/api/resource/v1/videoManagementServer

Get the information of the System Management Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/videoManagementServer
96
Request Parameters

Type
' / \ : * ? " < > |.
Response Parameters

characters.
data Opt. Object Information of the System
Management Server.
ip Opt. String IP address of the server, and the
port Opt. Number Port No. of the server.
cpu Opt. Number CPU usage of the server.
status Opt. Number Network status: 0-online, 1-offline.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"ip": "127.0.0.1",
"port": 443,
"cpu": 90,
"status": 0
97
}
}
5.3 Logical Resources API

Here provides APIs for the management of sites, areas, cameras, alarm inputs, alarm outputs,
vehicles, access points, organizations, persons, face comparison groups, faces, visitors, access
levels, and access groups.
5.3.1 Site Information
POST /artemis/api/resource/v1/site/advance/siteList
Set search condition (i.e., site name) to search the specified site, and fuzzy search is supported; if
the search condition is not configured, the information of all sites will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/site/advance/siteList
Request Parameters

Type
userId Opt. String Header User ID, which consists of up to
'/\:*?"<>|
500.
siteName Opt. String Body Site name, which consists of up
to 32 characters, but cannot
'/\:*?"<>|
98
Request Example
{
"pageNo": 1,
"pageSize": 10,
"siteName": "HikCentral Professional"
}
Response Parameters

characters.
list Opt. Array Site information list.
list[0] Opt. Object Information of a site in the list. See
details in SiteInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"siteIndexCode": "0",
99
"siteIp": "10.41.7.232",
"sitePort": "0",
"description": ""
},
{
"siteIp": "10.18.66.21",
"sitePort": "80",
"description": ""
}
]
}
}
POST /artemis/api/resource/v1/site/indexCode/siteInfo
Get the information of a site by site ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/site/indexCode/siteInfo
Request Parameters

Type
'/\:*?"<>|
siteIndexCode Req. String Body Site ID, which consists of up to
64 characters.
Request Example
{
"siteIndexCode": "17"
}
100
Response Parameters

characters.
data Opt. Object Site information. See details in
SiteInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"siteIp": "10.18.66.21",
"sitePort": "80",
"description": ""
}
}
POST /artemis/api/resource/v1/site/siteList
Get the information list of all sites, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/site/siteList
101
Request Parameters

Type
'/\:*?"<>|
pageNo Opt. Number Body The current page No., which is
pageSize Opt. Number Body Number of records on each
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

code Opt. String Response status or error code: 0-
characters.
msg Opt. String Status or error description, which is in
102

list Opt. Array Site information list.
list[0] Opt. Object Information of a site in the list. See
details in SiteInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"siteIp": "10.41.7.232",
"sitePort": "0",
"description": ""
},
{
"siteIp": "10.18.66.21",
"sitePort": "80",
"description": ""
}
]
}
}
5.3.2 Area Information
POST /artemis/api/resource/v1/region/indexCode/regionInfo
Get the area information by area ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/region/indexCode/regionInfo
103
Request Parameters

Type
'/\:*?"<>|
regionIndexCo Req. String Body Area ID, which consists of up to
de 64 characters.
siteIndexCode Opt. String Body Site ID, which consists of up to
64 characters. By default, it is
the current site.
Request Example
{
"regionIndexCode": "28",
}
Response Parameters

characters.
data Opt. Object Area information. See details in
RegionInfo .
Response Example
{
"code": "0",
104
"msg": "Success",
"data": {
"indexCode": "28",
"parentIndexCode": "-1",
"name": "10.18.65.98"
}
}
POST /artemis/api/resource/v1/regions
Get information list of all areas, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/regions
Request Parameters

Type
'/\:*?"<>|
500.
the current site.
Request Example
{
"pageNo": 1,
"pageSize": 2，
}
105
Response Parameters

characters.
list Opt. Array Area information list.
list[0] Opt. Object Information of an area in the list. See
details in RegionInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 40,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"indexCode": "1",
"name": "10.18.65.114"
},
{
"indexCode": "28",
"name": "10.18.65.98"
106
}
]
}
}
POST /artemis/api/resource/v1/regions/regionIndexCode/cameras
Get the camera list of a specified area by area ID, and the information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/regions/regionIndexCode/cameras
Request Parameters

Type
'/\:*?"<>|
de 64 characters.
500.
the current site.
deviceType Opt. String Body Device type (mobileDevice,
encodeDevice (default),
acsDevice), which consists of
up to 128 characters. Use
comma to separate multiple
items.
bRecordSettin Opt. Number Body Whether to get the recording
g settings: 0-yes, 1-no (by
default). When there is a large
107

Type
number of cameras, getting the
record settings will slow down
the API performance.
Request Example
{
"pageNo": 1,
"pageSize": 2,
"deviceType": "encodeDevice",
"bRecordSetting": 1
}
Response Parameters

characters.
data Opt. PageInfo Response data details.

108

list Opt. CameraInfo[] Information of a camera in the list.
See details in CameraInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"cameraName": "Simulator Channel",
"capabilitySet": "ptz,event_veh",
"recordType": "0",
"recordLocation": "1",
"status": 2
}
]
}
}
Remarks
The returned cameras do not contain child cameras.
POST /artemis/api/resource/v1/regions/subRegions
Get the area list of a specified parent area by resource type and permission.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/regions/subRegions
109
Request Parameters

Type
'/\:*?"<>|
parentIndexCo Opt. String Body Parent area No., which consists
de of up to 64 characters. By
default, it is the root area.
the current site.
Request Example
{
"parentIndexCode": "0"
}
Response Parameters

characters.
data Opt. Object Area information. See details in
RegionInfo .
110
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"list": [
{
"indexCode": "1",
"name": "10.18.65.114"
},
{
"indexCode": "28",
"name": "10.18.65.98"
},
{
"indexCode": "29",
"name": "10.41.7.131"
}
]
}
}
Remarks
The returned areas do not contain any child area, and both the cascading and non-cascading areas
will be returned.
5.3.3 Camera Information
POST /artemis/api/resource/v1/camera/advance/cameraList
Set search conditions (e.g., camera name, encoding device ID, and area ID) to search the specified
cameras, and fuzzy search is supported; if the search condition is not configured, the information
of all cameras will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/camera/advance/cameraList
111
Request Parameters

Type
'/\:*?"<>|
500.
cameraName Opt. String Body Camera name, which consists
of 1 to 32 characters, but
items.
devIndexCode String Body On-board device ID. It is valid
when encodeDevIndexCode is
empty.
encodeDevInd Opt. String Body Encoding device ID, which
exCode consists of up to 64 characters.
If the ID is specified, only the
cameras of the current level
will be searched.
regionIndexCo Opt. String Body Area ID, which consists of up to
de 64 characters.
112

Type
the current site.
Request Example
{
"pageNo": 1,
"pageSize": 100,
"deviceType": "encodeDevice"
"devIndexCode": "15",
"bRecordSetting": 1
}
Response Parameters

characters.
113

Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 100,
"list": [
{
"capabilitySet": "ptz",
"recordType": "0",
"status": 2
},
{
"recordType": "0",
"status": 2
}
]
}
}
114
Remarks
If there are multiple search conditions, they will be combined for search.
POST /artemis/api/resource/v1/cameras
Get the information list of all cameras, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/cameras
Request Parameters

Type
'/\:*?"<>|
500.
the current site.
items.
115
Request Example
{
"pageNo": 1,
"pageSize": 2,
"bRecordSetting": 1
}
Response Parameters

characters.
data Opt. Object Response data details. See details in

Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 51,
116
"pageNo": 1,
"pageSize": 2,
"list": [
{
"recordType": "0",
"status": 2
},
{
"recordType": "0",
"status": 2
}
]
}
}
POST /artemis/api/resource/v1/cameras/indexCode
Get the information of a specified camera by camera ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/cameras/indexCode
Request Parameters

Type
'/\:*?"<>|
cameraIndexC Req. String Body Camera ID, which consists of up
ode to 64 characters.
117
Request Example
{
"cameraIndexCode": "1213"
}
Response Parameters

characters.
data Opt. Object Response data details. See details in
CameraInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"devResourceType": "encodeDevice",
"DevIndexCode": "5",
"recordType": "0",
"status": 2
}
}
POST /artemis/api/resource/v1/regions/regionIndexCode/cameras
Get the camera list of a specified area by area ID, and the information is returned by page.
118
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/regions/regionIndexCode/cameras
Request Parameters

Type
'/\:*?"<>|
de 64 characters.
500.
the current site.
items.
Request Example
{
"pageNo": 1,
"pageSize": 2,
119
"bRecordSetting": 1
}
Response Parameters

characters.

Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
120
"capabilitySet": "ptz,event_veh",
"recordType": "0",
"status": 2
}
]
}
}
Remarks
The returned cameras do not contain child cameras.
5.3.4 Organization Information
POST /artemis/api/resource/v1/org/advance/orgList
Set search conditions (e.g., organization ID, organization name, and organization status) to search
for specified organization information and fuzzy search is supported; if the search condition is not
configured, the information of all organizations will be returned by page. It is a traversing search
method and the parent node will always be included in the returned result.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/advance/orgList
Request Parameters

Type
'/\:*?"<>|
orgName Opt. String Body Organization name, which
orgIndexCode Req. String Body Organization No., which
121

Type
500.
Request Example
{
"orgName": "test",
"pageNo": 1,
"pageSize": 10
}
Response Parameters

characters.
list Opt. Array Organization information list.
list[0] Opt. Object Information of an organization in the
list. See details in OrgInfo .
122
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"orgIndexCode": "1",
"orgName": "root",
"parentOrgIndexCode": "0"
},
{
"orgName": "test",
}
]
}
}
POST /artemis/api/resource/v1/org/orgIndexCode/orgInfo
Get organization information by organization ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/orgIndexCode/orgInfo
Request Parameters

Type
userId Opt. String Header User name, which cannot
contain punctuations or special
symbols like ' / \ : * ? " < > |,
and it consists of up to 32
characters.
orgIndexCode Req. String Body Organization ID, which consists
of up to 64 characters.
123
Request Example
{
"orgIndexCode": "3"
}
Response Parameters

to Status or Error Code for details); it
details. It consists of up to 256
characters.
data Opt. Object Organization information. See details
in OrgInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"orgName": " name_test ",
}
}
POST /artemis/api/resource/v1/org/orgList
Get the information list of all organizations, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/orgList
124
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 100
}
Response Parameters

characters.
125

Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 3,
"pageNo": 1,
"pageSize": 100,
"list": [
{
"orgName": "root",
},
{
"orgName": "test",
},
{
"orgName": " name_test ",
}
]
}
}
POST /artemis/api/resource/v1/org/parentOrgIndexCode/subOrgList
Get information list of lower-level organizations by parent organization, and all information is
returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/parentOrgIndexCode/subOrgList
126
Request Parameters

Type
symbols like ' / \ : * ? " < > |,
characters.
parentOrgInde Req. String Body Parent organization No., which
xCode consists of up to 64 characters.
500.
Request Example
{
"parentOrgIndexCode": "1",
"pageNo": 1,
"pageSize": 10
}
Response Parameters

characters.
127

Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"orgName": "test",
},
{
"orgName": "name_test",
}
]
}
}
POST /artemis/api/resource/v1/org/rootOrg
Get the root organization information.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/rootOrg
128
Request Parameters

Type
'/\:*?"<>|
Response Parameters

characters.
data Opt. Object Root organization information. See
details in OrgInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"orgName": "root",
}
}
POST /artemis/api/resource/v1/org/single/add
Add an organization.
129
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/single/add
Request Parameters

Type
symbols like ' / \ : * ? " < > |,
characters.
parentIndexCo Req. String Body Parent organization ID, which
de consists of up to 64 characters.
orgName Req. String Body Organization name, which
Request Example
{
"orgName": "name",
}
Response Parameters

characters.
data Opt. Object Organization information. See details
in OrgInfo .
130
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"orgName": "name",
}
}
POST /artemis/api/resource/v1/org/single/delete
Delete an organization.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/single/delete
Request Parameters

Type
symbols like ' / \ : * ? " < > |,
characters.
Request Example
{
"orgIndexCode": "4"
}
Response Parameters

131

characters.
data Opt. String Response data details, if succeeded,
this field is null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/org/single/update
Edit the information of an organization.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/org/single/update
Request Parameters

Type
'/\:*?"<>|
parentIndexCo Req. String Body Parent organization ID, which
132

Type
orgName Req. String Body Organization name, which
Request Example
{
"orgName": "name_test",
}
Response Parameters

Each code consists of up to 32
characters.
details. Each description consists of
data Opt. String Returned result, if succeeded, this
field is null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
133
5.3.5 Access Point Information
POST /artemis/api/resource/v1/acsDoor/acsDoorList
Get the information list of all access points, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDoor/acsDoorList
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

134

characters.
list Opt. Array Access point information list.
list[0] Opt. Object Information of an access point in the
list. See details in DoorInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 6,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"doorIndexCode": "938",
"doorNo": "6",
"doorName": "Door 01",
"doorState": 4
},
{
"doorNo": "5",
"doorName": "Door1",
"doorState": 0
}
]
135
}
}
POST /artemis/api/resource/v1/acsDoor/advance/acsDoorList
Set search condition (i.e., access point name, access control device ID, and area ID) to search the
specified access point, and fuzzy search is supported; if the search condition is not configured, the
information of all access points will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDoor/advance/acsDoorList
Request Parameters

Type
'/\:*?"<>|
500.
doorName Opt. String Body Access point name, which
consists of 1 to 32 characters,
acsDevIndexC Opt. String Body Access control device ID, which
de 64 characters.
Request Example
{
"pageNo": 1,
"pageSize": 2,
136
"regionIndexCode": "77"
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"doorNo": "6",
"doorState": 4
}
]
137
}
}
POST /artemis/api/resource/v1/acsDoor/indexCode/acsDoorInfo
Get the information of a specified access point by access point ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDoor/indexCode/acsDoorInfo
Request Parameters

Type
'/\:*?"<>|
doorIndexCod Req. String Body Access point ID, which consists
e of up to 64 characters.
Request Example
{
"doorIndexCode": "938"
}
Response Parameters

characters.
138

data Opt. Object Access point information. See details
in DoorInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"doorNo": "6",
"doorState": 4
}
}
POST /artemis/api/resource/v1/acsDoor/region/acsDoorList
Get the information list of access points in a specified area by area ID, and the information is
returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/acsDoor/region/acsDoorList
Request Parameters

Type
'/\:*?"<>|
139

Type
500.
de 64 characters.
Request Example
{
"regionIndexCode": "f182356d-8647-4fd8-96d0-cf635e9293cd",
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
140
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 2,
"list": [{
"doorIndexCode": "9290949c81434d2a84a06a6d127cefd6",
"doorName": "A14906_A14906_door1",
"doorNo": "1",
"acsDevIndexCode": "c322b802d3a4453b9923792acc5d6a25"
},
{
"doorIndexCode": "c0d46ff668134e4f816fe6921f2d5070",
"doorName": "A14906_A14906_door2",
"doorNo": "2",
"acsDevIndexCode": "c322b802d3a4453b9923792acc5d6a25"
}]
}
}
POST /artemis/api/resource/v1/reader/search
Get card reader information.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/reader/search
Request Parameters

Type
141

Type
'/\:*?"<>|
doorIndexCod Req. String Body Access point ID, which consists
readerIndexCo Opt. String Body Card reader ID, which consists
de of up to 64 characters.
Request Example
{
"doorIndexCode": "938"
}
Response Parameters

characters.
list Opt. Array List of card reader information.
list[0] Opt. Object Information of a card reader. See
details in ReaderInfo .
Response Example
{
"code": "0",
"msg": "Success",
142
"data": {
"total": 2,
"list": [
{
"indexCode": "5",
"name": "Cardreader 01",
"enable": 0
},
{
"indexCode": "6",
"name": "Cardreader 02",
"enable": 0
}
]
}
}
5.3.6 Vehicle Information
POST /artemis/api/resource/v1/vehicle/advance/vehicleList
Set search condition (i.e., license plate number, vehicle owner name, and owner contact number)
to search the specified vehicles, and fuzzy search is supported; if the search condition is not
configured, the information of all vehicles will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/advance/vehicleList
Request Parameters

Type
'/\:*?"<>|
plateNo Opt. String Body License plate number, which
personName Opt. String Body Vehicle owner name, which
143

Type
phoneNo Opt. String Body Contact number of vehicle
owner, which consists of up to
64 characters.
vehicleGroupI Req. String Body Vehicle group ID, which
ndexCode consists of up to 64 characters.
500.
Request Example
{
"pageNo": 1,
"pageSize": 10,
"personName": "",
"plateNo": "N746",
"phoneNo": "",
"vehicleGroupIndexCode": "1"
}
Response Parameters

characters.
144

list Opt. Array Vehicle information list.
list[0] Opt. Object Information of a vehicle in the list.
See details in VehicleInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"vehicleId": "20",
"plateNo": "NN7464",
"personName": "test test",
"personFamilyName": "test",
"personGivenName": "test",
"phoneNo": "",
"vehicleColor": 3,
}
]
}
Remarks
The search conditions, i.e., license plate number, vehicle owner name, and owner contact number,
are mutually exclusive. That is, they cannot be configured for search at same time.
POST /artemis/api/resource/v1/vehicle/indexCode/vehicleInfo
Get the information of a specified vehicle by vehicle ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/indexCode/vehicleInfo
145
Request Parameters

Type
vehicleIndexC Req. String Body Vehicle ID, which consists of up
Request Example
{
"vehicleIndexCode": "7 "
}
Response Parameters

characters.
data Opt. Object Vehicle information. See details in
VehicleInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"vehicleId": "7",
"plateNo": "AB5555",
"personName": "1 2",
"phoneNo": "",
"vehicleColor": 0,
}
146
POST /artemis/api/resource/v1/vehicle/single/add
Add a vehicle.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/single/add
Request Parameters

Type
'/\:*?"<>|
plateNo Req. String Body License plate number, which
personId Opt. String Body Person ID, which consists of up
to 128 characters.
personGivenN Opt. String Body Person's given name, which
ame consists of 1 to 256 characters,
personFamily Opt. String Body Person's family name, which
Name consists of 1 to 256 characters,
phoneNo Opt. String Body Person's contact number,
"<>|
vehicleColor Opt. Number Body Vehicle color code: 0-other
color, 1-white, 2- sliver, 3-grey,
4-black, 5-red, 6-dark blue, 7-
blue, 8-yellow, 9-green, 10-
147

Type
brown, 11-pink, 12- purple, 13-
dark blue, 14-cyan.
ndexcode consists of up to 64 characters.
effectiveDate Req. String Body Start time of vehicle validity, in
ISO 8601 format, which is
represented by "yyyy- MM-
ddTHH:mm:ss+current time
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String Body Vehicle expiry date, in ISO 8601
format, which is represented
by "yyyy- MM-ddTHH:mm:ss
+current time zone", e.g.,
"2018-07- 26T15:00:00
+ 08:00".
Request Example
{
"personId": "1149",
"phoneNo": "111111",
"vehicleColor": 3,
"vehicleGroupIndexCode": "1",
"personGivenName": "ma",
"personFamilyName": "jack",
"effectiveDate": "2022-03-21T00:00:00+08:00",
"expiredDate": "2023-03-25T23:59:59+08:00"
}
Response Parameters

148

characters.
data Opt. Object Vehicle information, refer to
VehicleInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"vehicleId": "20",
"phoneNo": "",
"vehicleColor": 3,
"effectiveDate": "2022-03-21T00:00:00+08:00",
"expiredDate": "2023-03-25T23:59:59+08:00"
}
}
POST /artemis/api/resource/v1/vehicle/single/delete
Delete a vehicle
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/single/delete
Request Parameters

Type
149

Type
'/\:*?"<>|
vehicleId Req. String Body Vehicle ID, which consists of up
to 65 characters.
Request Example
{
"vehicleId": "12"
}
Response Parameters

characters.
data Opt. / /
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/vehicle/single/update
Edit information of a vehicle.
150
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/single/update
Request Parameters

Type
'/\:*?"<>|
vehicleId Req. String Body Vehicle ID, which consists of up
to 65 characters.
ndexcode consists of up to 64 characters.
plateNo Req. String Body License plate number, which
personId Opt. String Body Person ID, which consists of up
to 128 characters.
phoneNo Opt. String Body Person's contact number,
"<>|
vehicleColor Opt. Number Body Vehicle color code: 0-other
color, 1-white, 2- sliver, 3-grey,
4-black, 5-red, 6-dark blue, 7-
blue, 8-yellow, 9-green, 10-
151

Type
brown, 11-pink, 12- purple, 13-
dark blue, 14-cyan.
effectiveDate Req. String Body Start time of vehicle validity, in
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String Body Vehicle expiry date, in ISO 8601
"2018-07- 26T15:00:00
+ 08:00".
Request Example
{
"vehicleId": "21",
"plateNo": "74651544B",
"personId": "1149",
"phoneNo": "111111111111",
"vehicleColor": 3,
"personFamilyName": "dong",
"personGivenName": "zhaod",
"effectiveDate": "2022-03-21T00:00:00+08:00",
"expiredDate": "2023-03-25T23:59:59+08:00"
}
Response Parameters

152

characters.
data Opt. / /
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/vehicle/vehicleList
Get the information list of all vehicles, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicle/vehicleList
Request Parameters

Type
'/\:*?"<>|
153

Type
500.
ndexCode consists of up to 32 characters.
Request Example
{
"pageNo": 1,
"pageSize": 10
"vehicleGroupIndexCode": “1”
}
Response Parameters

characters.
list Opt. Array Vehicle information list.
list[0] Opt. Object Information of a vehicle in the list.
See details in VehicleInfo .
154
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"vehicleId": "7",
"plateNo": "888",
"personName": "1 2",
"personFamilyName": "2",
"personGivenName": "1",
"phoneNo": "",
"vehicleColor": 0,
}
]
}
}
POST /artemis/api/resource/v1/vehicleGroup/single/add
Add a vehicle group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicleGroup/single/add
Request Parameters

Type
'/\:*?"<>|
vehicleGroup Req. String Body Vehicle group name, which
155

Type
description Opt. String Body Description, which consists of 1
'/\:*?"<>|
Request Example
{
"vehicleGroupName": "test",
"description": "test"
}
Response Parameters

characters.
data Opt. Object Vehicle group information, refer to
VehicleGroupInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"vehicleGroupName": "test",
156
}
}
POST /artemis/api/resource/v1/vehicleGroup/single/delete
Delete a vehicle group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicleGroup/single/delete
Request Parameters

Type
'/\:*?"<>|
ndexCode consists of 1 to 64 characters.
Request Example
{
}
Response Parameters

characters.
157

data Opt. / /
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/vehicleGroup/single/update
Edit the information of a vehicle group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicleGroup/single/update
Request Parameters

Type
'/\:*?"<>|
ndexCode consists of 1 to 64 characters.
vehicleGroup Req. String Body Vehicle group name, which
description Opt. String Body Description, which consists of 1
'/\:*?"<>|
158
Request Example
{
"vehicleGroupName": "test_mod",
"description": "test_mod"
}
Response Parameters

characters.
data Opt. / /
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/vehicleGroup/vehicleGroupList
Get the information list of all vehicle groups, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/vehicleGroup/vehicleGroupList
159
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 10
}
Response Parameters

characters.
160

list Opt. Array Vehicle group information list.
list[0] Opt. Object Information of a vehicle group in the
list. See details in VehicleGroupInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"vehicleGroupName": "group_one",
"description": ""
},
{
"vehicleGroupName": "1",
"description": ""
}
]
}
}
5.3.7 Vehicle Linked to On-Board Device
POST /artemis/api/resource/v1/mobilevehicle/mobilevehicleList
Get the list of vehicles linked to on-board devices. The returned results will be displayed in page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobilevehicle/mobilevehicleList
161
Request Parameters

Type
>|
2147483647.
each page, which is
between 1 and 500.
Request Example
{
"pageNo": 1,
"pageSize": 10
}
Response Parameters

characters.
data Opt. PageInfo Vehicle information structure.
162

list Opt. MobilevehivleInfo List of vehicles linked to on-board
devices.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"mobilevehicleIndexCode": "3",
"mobilevehicleName": "zhe123",
"status": "1",
"plateNo": "zhe123",
"personName": "ljf",
"personFamilyName": "l",
"personGivenName": "jf",
"phoneNo": "2345346",
"vehicleColor": "1",
"vehicleType": "1",
"vehicleBrand": "1"
}
]
}
}
POST /artemis/api/resource/v1/mobileVehicle/indexCode/mobileVehicleInfo
Get the information of a vehicle linked to the on-board device according to the vehicle ID.
163
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobileVehicle/indexCode/
mobileVehicleInfo
Request Parameters

Type
'/\:*?"<>|
mobilevehicleI Req. String Body ID of vehicle linked to the on-
ndexCode board device. The maximum
Request Example
{
"mobilevehicleIndexCode": "1"
}
Response Parameters

characters.
data Req. MobilevehivleInfo Response data details.
Response Example
{
"code": "0",
164
"msg": "Success",
"data": {
"status": 2,
"personFamilyName": "",
"personGivenName": "",
"personName": "",
"phoneNo": "",
"vehicleType": -1,
"vehicleBrand": -1,
"vehicleColor": -1
}
}
POST /artemis/api/resource/v1/mobilevehicle/advanced/mobilevehicleList
Search the list of vehicles linked to on-board devices by condition. The returned results will be
displayed in page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/mobilevehicle/advanced/
mobilevehicleList
Request Parameters

Type
'/\:*?"<>|
500.
mobilevehicle Opt. String Body Name of vehicle linked to the
Name on-board device. This field
consists of up to 32 characters,
165

Type
characters like ' / \ : * ? " < >.
Fuzzy search is supported.
devIndexCode Opt. String Body Device ID. When this field is
set, results of vehicles which
are linked to the specific on-
board device will be returned.
The maximum length is 64
characters.
de 64 characters.
Request Example
{
"pageNo": 1,
"pageSize": 10,
"mobilevehicleName":"10.18.68.12",
"devIndexCode":"1"
}
Response Parameters

characters.
data Opt. PageInfo Vehicle information structure.
166

list Opt. MobilevehivleInfo Response data details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"status": "1",
"personName": "ljf",
"personFamilyName": "l",
"personGivenName": "jf",
"phoneNo": "2345346",
"vehicleColor": "1",
"vehicleType": "1",
"vehicleBrand": "1"
}
]
}
}
167
5.3.8 Person Information
POST /artemis/api/resource/v1/person/advance/personList
Set search condition (i.e., person name) to search the specified person, and fuzzy search is
supported; if the search condition is not configured, the information of all persons will be returned
by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/advance/personList
Request Parameters

Type
'/\:*?"<>|
500.
personName Opt. String Body Person name, which consists of
up to 32 characters, but cannot
'/\:*?"<>|
Request Example
{
"pageNo": 1,
"pageSize": 10,
"personName": "test"
}
168
Response Parameters

characters.
list Opt. Array Person information list.
list[0] Opt. Object Information of a person in the list. See
details in PersonInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"personId": "1149",
"personCode": "3536895491",
"gender": 0,
"phoneNo": "",
"personPhoto": {
"picUri": ""
169
},
"email": "",
"remark": "",
"beginTime": "2021-04-25T16:19:27+08:00",
"endTime": "2031-04-25T16:19:27+08:00",
"cards": [
{
"cardNo": "234324"
}
],
"customFieldList": [
{
"id": "12",
"customFiledName": "Home Adrress",
"customFieldType": 0,
"customFieldValue": ""
},
{
"id": "13",
"customFiledName": "Salary",
},
{
"id": "14",
"customFiledName": "time",
}
]
}
]
}
}
POST /artemis/api/resource/v1/person/customFields
Get the person's custom information list, and all the information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/customFields
170
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
171

list Opt. Array Persons' custom information list.
list[0] Opt. Object Custom information about a person.
See details in CustomField .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 3,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"id": "12",
"customFieldType": 0
},
{
"id": "13",
"customFieldType": 0
}
]
}
}
POST /artemis/api/resource/v1/person/face/update
Edit the information of face linked with the person.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/face/update
Request Parameters

Type
172

Type
'/\:*?"<>|
personId Req. String Body Person ID, which is returned
when adding person and
If this field is not configured,
the platform will automatically
generate an ID.
faceData Req. String Body Face information of the person
encoded by Base64.
Request Example
{
"personId": "1",
"faceData": " AQSkzFYSEbxpSTWIl7lb2dtYSUW4"
}
Response Parameters

characters.
data Opt. String Response result, if succeeded, this
field is null.
Response Example
{
"code": "0",
"msg": "Success",
173
"data":””
}
POST /artemis/api/resource/v1/person/fingerPrints/update
Edit the information of fingerprints linked with the person.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/fingerPrints/update
Request Parameters

Type
'/\:*?"<>|
generate an ID.
fingerPrint Opt. Array Body Fingerprint information list.
fingerPrint[0] Opt. Object Body Information of a fingerprint in
the list, refer to FingerPrint for
details.
Request Example
{
"personId": "1",
"fingerPrint": [
{
"fingerPrintIndexCode": "1",
"fingerPrintName": "fringe_pringt_01",
"fingerPrintData": "228697F1AD0146C8D00",
"relatedCardNo": "1123"
}
]
}
174
Response Parameters

characters.
data Opt. Array List of fingerprint updating results.
data[0] Opt. Object A fingerprint updating result in the
list, see details in
fingerPrintUpdateResult .
Response Example
{
"code": "0",
"msg": "Success",
"data":””
}
POST /artemis/api/resource/v1/person/personCode/personInfo
Get person information according to person code.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/personCode/personInfo
Request Parameters

Type
175

Type
'/\:*?"<>|
personCode Req. string Body Person code, which consists of
Request Example
{
"personCode": "3536895491"
}
Response Parameters

characters.
data Opt. Object Person information. See details in
PersonInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"personId": "1149",
"personCode": "3536895491",
"gender": 0,
"personPhoto": {
176
"picUri": ""
},
"phoneNo": "",
"email": "",
"remark": "",
"beginTime": "2021-04-25T16:19:27+08:00",
"endTime": "2031-04-25T16:19:27+08:00",
"cards": [
{
"cardNo": "234324"
}
],
"CustomField": [
{
"id": "12",
},
{
"id": "13",
},
{
"id": "14",
}
]
}
}
POST /artemis/api/resource/v1/person/personId/customFieldsUpdate
Edit the person's custom information.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/personId/
customFieldsUpdate
177
Request Parameters

Type
'/\:*?"<>|
personId Req. String Body Person ID, which consists of up
to 64 characters.
list Opt. Array Body List of person custom
information.
list[0] Opt. Object Body Custom information of a
person. See details in
CustomField .
Request Example
{
"personId": "1150",
"list": [
{
"id": "12",
"customFiledName": "ssss",
"customFieldValue": "2354"
}
]
}
Response Parameters

characters.
178

Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/person/personId/personInfo
Get the information of a specified person by person ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/personId/personInfo
Request Parameters

Type
'/\:*?"<>|
personId Req. String Body Person ID, which consists of up
to 64 characters.
Request Example
{
"personId": "1149"
}
179
Response Parameters

characters.
data Opt. Object Person information. See details in
PersonInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"personId": "1149",
"personCode": "3536895491",
"gender": 0,
"personPhoto": {
"picUri": ""
},
"phoneNo": "",
"email": "",
"remark": "",
"beginTime": "2021-04-25T16:19:27+08:00",
"endTime": "2031-04-25T16:19:27+08:00",
"cards": [
{
"cardNo": "234324"
}
],
{
"id": "12",
180
},
{
"id": "13",
},
{
"id": "14",
}
]
}
}
POST /artemis/api/resource/v1/person/personList
Get the information list of all persons, and all information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/personList
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
181
"pageSize": 2
}
Response Parameters

characters.
list[0] Opt. Object Information of a person in the list. See
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 37,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"personId": "1149",
"personCode": "3536895491",
"gender": 0,
"phoneNo": "",
182
"personPhoto": {
"picUri": ""
},
"email": "",
"remark": "",
"beginTime": "2021-04-25T16:19:27+08:00",
"endTime": "2031-04-25T16:19:27+08:00",
"cards": [
{
"cardNo": "234324"
}
],
{
"id": "12",
},
{
"id": "13",
},
{
"id": "14",
}
]
},
{
"personId": "1135",
"personCode": "2357358552",
"personName": "John",
"personFamilyName": "",
"personGivenName": "John",
"gender": 0,
"phoneNo": "",
"personPhoto": {
"picUri": "0B4E92A30AF914C1285613A4FBD9F761F"
},
"email": "",
"remark": "",
"beginTime": "2021-04-15T17:07:41+08:00",
"endTime": "2031-04-15T17:07:41+08:00",
{
"id": "12",
183

},
{
"id": "13",
},
{
"id": "14",
}
]
}
]
}
}
POST /artemis/api/resource/v1/person/picture_data
Get the URI of profile picture uploaded when adding person, and then download the picture from
Recording Server according to the URL.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/picture_data
Request Parameters

Type
domainId Opt. Number Header Domain ID, which consists of
picUri Req. String Body Relative URI of picture, which is
returned when adding persons.
And the URI contains up to 256
characters.
when adding persons. And the
ID contains up to 64 characters.
184
Request Example
{
"personId": "1135",
"picUri": "0B4E92A30AF914C1285613A4FBD9F761F"
}
Response Parameters

characters.
data Opt. String Returned picture data.
Response Example
"data:image/jpeg;base64,/9j/4AAQSkzFYSEbxpSTWIl7lb2dtYSUW4zd9E/K/U+h9Ls
49L0y20yFyy29ukSs3UhVAB/SigyEjFFG5+2RioRUV0P/2Q=="
"data:image/jpeg;base64,/9j/4AAQSkzFYSEbxpSTWIl7lb2dtYSUW4zd9E/K/U+h9Ls4
9L0y20yFyy29ukSs3UhVAB/SigyEjFFG5+2RioRUV0P/2Q=="
POST /artemis/api/resource/v1/person/single/add
Add a person.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/single/add
185
Request Parameters

Type
'/\:*?"<>|
personCode Opt. String Body Person No., which consists of
personGivenN Req. String Body Person name, which consists of
ame up to 256 characters.
personFamily Req. String Body Person's last name, which
Name consists of up to 256
characters.
gender Opt. String Body Person's gender: 1-male, 2-
female, 0-unknown.
orgIndexCode Req. String Body Person's organization ID.
phoneNo Opt. String Body Person's mobile phone number.
email Opt. String Body Person's email address.
faces Opt. Array Body Face information list.
faces[0] Opt. Object Body Information of a face in the list,
refer to face for details.
fingerPrint Opt. Array Body Fingerprint information list.
fingerPrint[0] Opt. Object Body Information of a fingerprint in
the list, refer to FingerPrint for
details.
remark Opt. String Body Remarks, which consists of up
to 128 characters.
cards Opt. Array Body Card information list.
cards[0] Opt. Object Body Information of a card in the list,
refer to Card for details.
beginTime Opt. String Body Start time in ISO 8601 format,
which is represented by "yyyy-
186

Type
MM-ddTHH:mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
endTime Opt. String Body End time in ISO 8601 format,
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
Request Example
{
"personCode": "123245214",
"personFamilyName": "LI",
"personGivenName": "person0",
"gender": 1,
"remark": "description",
"phoneNo": "13000110011",
"email": "person1@qq.com",
"cards": [
{
"cardNo": "123456"
}
],
"beginTime": "2020-05-26T15:00:00+08:00",
"endTime": "2030-05-26T15:00:00+08:00"
}
Response Parameters

187

characters.
data Opt. String Added person ID.
Response Example
{
"code": "0",
"msg": "Success",
"data": "1150"
}
POST /artemis/api/resource/v1/person/single/delete
Delete a person.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/single/delete
Request Parameters

Type
'/\:*?"<>|
generate an ID.
188
Request Example
{
"personId ": "1"
}
Response Parameters

characters.
data Opt. String Response details, if succeeded, this
field is null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/person/single/update
Edit a person's information.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/single/update
189
Request Parameters

Type
'/\:*?"<>|
personCode Opt. String Body Person No., which consists of
personGivenN Opt. String Body Person name, which consists of
ame up to 256 characters.
personFamily Opt. String Body Person's last name, which
Name consists of up to 256
characters.
gender Opt. Number Body Person's gender: 1-male, 2-
female, 0-unknown.
orgIndexCode Opt. String Body Person's organization ID. This
field is not required when
editing the person's name.
phoneNo Opt. String Body Person's mobile phone number.
email Opt. String Body Person's email address.
remark Opt. String Body Remarks, which consists of up
to 128 characters.
cards Opt. Array Body Card information list.
cards[0] Opt. Object Body Information of a card in the list,
refer to Card for details.
beginTime Opt. String Body Start time in ISO 8601 format,
time zone", e.g., "2018-07-
190

Type
26T15:00:00 + 08:00". The
endTime Opt. String Body End time in ISO 8601 format,
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
Request Example
{
"personId": "1150",
"personCode": "123245214",
"personFamilyName": "Li",
"personGivenName": "person0",
"gender": 1,
"phoneNo": "13000110011",
"remark": "description",
"email": "person1000@qq.com",
"cards": [
{
"cardNo": "123456"
}
],
"beginTime": "2022-05-26T15:00:00+08:00",
"endTime": "2030-05-26T15:00:00+08:00"
}
Response Parameters

characters.
191

data Opt. String Response result, if succeeded, this
field is null.
Response Example
{
"code": "0",
"msg": "ok",
"data":””
}
POST /artemis/api/acs/v1/faceCheck
Verify the validity of face picture (a few seconds are required for verifying a picture). Currently, the
API is only supported by the MinMoe (i.e., Face Recognition Terminal). It is used for linking face
picture to the person when adding a person.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/faceCheck
Request Parameters

Type
'/\:*?"<>|
faceData Req. String Body Face picture data (Base64).
acsDevIndexC Req. String Body Access control device ID, which
Request Example
{
"faceData": "4AAQSkzFYSEbxpSTWIl7lb2dtYSUW4zd9E/K",
192
"acsDevIndexCode": "1"
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data":””
}
POST /artemis/api/resource/v1/person/customFields/single/add
Add a custom field.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/customFields/single/add
Request Parameters

Type
193

Type
'/\:*?"<>|
customFieldLis Opt. CustomField [] Body List of custom fields. See details
t in CustomField .
Request Example
{
"customFieldList": {
"customField": [
{
"customFieldName": "123",
"presetValueList": {
"presetValue": [
{
"value": "0",
"ID": "1"
}
]
},
"isPublic": 0,
"isShow": 1
}
]
}
}
Response Parameters

characters.
194

Response Example
{
"code": "0",
"msg": "Success",
"data":{
"Id": "1",
"customFieldName": "wwww",
"isPublic": 0
}
}
POST /artemis/api/resource/v1/person/customFields/single/modify
Edit the custom field information.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/customFields/single/modify
Request Parameters

Type
'/\:*?"<>|
customFieldLis Opt. CustomField [] Body List of custom fields. See details
t in CustomField .
Request Example
{
"customFieldList": {
"customField": [
{
195
"customFieldId": "1",
"customFieldName": "123",
"isShow": 1,
"customFieldName": 3,
"presetValueList": {
"presetValue": [
{
"value": "0",
"ID": "1"
}
]
}
}
]
}
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data":""
}
POST /artemis/api/resource/v1/person/customFields/single/delete
Delete a custom field. Custom fields related to person information in the AD domain cannot be
deleted.
196
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/person/customFields/single/delete
Request Parameters

Type
'/\:*?"<>|
customFieldId Req. String Body Custom field ID.
Request Example
{
"customFieldId": "1"
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
197
5.3.9 Face Comparison Group
POST /artemis/api/frs/v1/face/group
Set search condition (i.e., group ID and group name) to search the specified face comparison
groups, and fuzzy search is supported; if the search condition is not configured, the information of
all face comparison groups will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/group
Request Parameters

Type
'/\:*?"<>|
indexCodes Opt. Array Body A set of face comparison group
IDs, currently, only one ID is
supported. And each ID
indexCodes[0] Opt. String Body A face comparison group ID in
the list.
name Opt. String Body Name of face comparison
group, which consists of 1 to 32
" < >. It is for fuzzy search.
Request Example
{
"indexCodes": [
"2"
],
"name": ""
}
198
Response Parameters

characters.
data Opt. Array Information list of face comparison
groups.
data[0] Opt. Object Information of a face comparison
group in the list. See details in
FaceGroupInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"list": [
{
"indexCode": "2",
"name": "test_group",
"description": ""
}
]
}
}
POST /artemis/api/frs/v1/face/group/batch/deletion
Delete a face comparison group by group ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/group/batch/deletion
199
Request Parameters

Type
'/\:*?"<>|
indexCode Req. Array of String Body Array of face comparison group
IDs, but currently, only one ID
can be set in the array. If no ID
or multiple IDs are specified,
error will be returned.
Request Example
{
"indexCodes": [
"1"
]
}
Response Parameters

characters.
field is null.
200
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
Remarks
The validity of face comparison group ID will be checked when deleting by ID, if the ID is invalid,
POST /artemis/api/frs/v1/face/group/single/addition
Add a face comparison group, and the group ID will be returned after adding.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/group/single/addition
Request Parameters

Type
'/\:*?"<>|
name Req. String Body Name of face comparison
description Opt. String Body Description of face comparison
group, which contains 1 to 128
"<>
Request Example
{
"name": "name",
201
}
Response Parameters

characters.
data Opt. Array Information list of face comparison
groups.
data[0] Opt. Object Information of a face comparison
FaceGroupInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"indexCode": "1",
"name": "name",
}
}
POST /artemis/api/frs/v1/face/group/single/update
Edit information of a face comparison group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/group/single/update
202
Request Parameters

Type
'/\:*?"<>|
indexCode Req. String Body Face comparison group IDs,
which can be obtained by
searching for face comparison
groups by condition. The ID
name Req. String Body Name of face comparison
description Opt. String Body Description of face comparison
group, which contains 1 to 128
" < >. This field will be set to
null if no value is transmitted
to.
Request Example
{
"indexCode": "1",
"name": "name_mod",
"description": "test_mod"
}
Response Parameters

203

characters.
field is null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
Remarks
If the face comparison group to be edited is already added to the identification schedule, after
editing, the changed information will also be applied to device.
POST /artemis/api/frs/v1/face/groupList
Get face comparison group list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/groupList
Request Parameters

Type
204

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 6
}
Response Parameters

characters.
205

list Opt. Array Information list of face comparison
groups.
list[0] Opt. Object Information of a face comparison
FaceGroupInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 500,
"list": [
{
"indexCode": "2",
"name": "test_group",
"description": ""
},
{
"indexCode": "1",
"name": "1111@@@@@@@@",
"description": "erryttttttttttttttttttttttttttt###"
}
]
}
}
POST /artemis/api/frs/v1/plan/recognition/black/restart
Apply all faces' information of the face comparison group to the linked device.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/plan/recognition/black/restart
206
Request Parameters

Type
'/\:*?"<>|
indexCode Req. String Body Array of face comparison group
IDs, but currently, only one ID
can be set in the array. If no ID
or multiple IDs are specified,
Request Example
{
"indexCodes": "1"
}
Response Parameters

characters.
field is null.
Response Example
{
"code": "0",
"msg": "Success",
207
"data": ""
}
POST /artemis/api/aiapplication/v1/face/faceMatchRecord
Search for the face comparison information by camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/aiapplication/v1/face/faceMatchRecord
Request Parameters

Type
'/\:*?"<>|
500.
cameraIndexC Opt. String Body Camera ID, the maximum
odes length is 1024 characters. Use
items. Up to 10 IDs are
allowed.
personIndexC Opt. String Body Person ID, the maximum length
odes is 1024 characters. Use comma
to separate multiple items. Up
to 10 IDs are allowed.
faceGroupInde Opt. String Body Face comparison group ID, the
xCodes maximum length is 1024
characters. Use comma to
separate multiple items. Up to
10 IDs are allowed.
startTime Req. String Body Start time of search, which is in
ISO 8601 standard time format:
208

Type
yyyy-MM-
dd'T'HH:mm:ss.SSSzzz, e.g.,
2018-07-26T15:00:00 + 08:00.
And the time consists of up to
64 characters.
endTime Req. String Body End time of search, which is in
yyyy-MM-
2018-07-26T15:00:00 + 08:00.
64 characters.
temperatureSt Opt. Number Body Temperature status: -1 (all), 0
atus (unknown), 1 (normal), 2
(exception).
maskStatus Opt. Number Body Mask status: -1 (all), 0
(unknown), 1 (wearing mask), 2
(no mask).
temperatureT Opt. String Body Temperature threshold.
hreshold
Request Example
{
"pageNo":1,
"pageSize":20,
"cameraIndexCodes":"1",
"statisticsType":0,
"startTime":"2018-07-26T15:00:00+08:00",
"endTime":"2018-07-26T16:00:00+08:00"
}
Response Parameters

209

characters.
pageNo Opt. Number The current page No, the maximum
pageSize Opt. Number Number of records on each page, the
maximum length is 32 characters.
list Opt. Array List of face comparison information.
list[0] Opt. FaceMatchRecord Face comparison information.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"completeness":1,
"pageNo":1,
"pageSize":20,
"list":[{
"time":"2018-07-26T15:00:00+08:00",
"cameraIndexCode":"1",
"exitNum":5,
"enterNum":1
}]
}
}
5.3.10 Face Information
POST /artemis/api/frs/v1/application/picture
Download the picture according to the specified URL.
210
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/application/picture
Request Parameters

Type
'/\:*?"<>|
url Req. String Body Picture URL, which should start
with "Dev://", "Server"//", and
"Vsm://". The URL consists of
isHumanSearc Opt. Number Body 0-not returned from picture
hPic comparison on Intelligent
Fusion Server; 1-returned from
picture comparison on
Intelligent Fusion Server.
Request Example
{
"url": "Dev://picture/Streaming/tracks/303/?name=405812&size=405812&DEVICE=26&TYPE=0&VSM=0",
"isHumanSearchPic": 0
}
Response Parameters

characters.
211

data Opt. / Picture data.
Response Example
"data:image/jpeg;base64,/9j/4AAQSkzFYSEbxpSTWIl7lb2dtYSUW4zd9E/K/U+h9Ls49L0y20yFyy29ukSs3UhVAB/
SigyEjFFG5+2RioRUV0P/2Q=="
POST /artemis/api/frs/v1/face
Search face information in a specified face comparison group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face
Request Parameters

Type
'/\:*?"<>|
faceGroupInde Req. String Body Face comparison group ID,
xCode which can be obtained by
getting face comparison group
by condition.
500.
212
Request Example
{
"faceGroupIndexCode": "1",
"pageNo": 1,
"pageSize": 20
}
Response Parameters

characters.
list Opt. Array Face information list.
list[0] Opt. Object Information of a face in the list. See
details in FaceInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1
"pageNo": 1,
"pageSize": 20,
"list": [
{
"indexCode": "4",
"faceInfo": {
213
"personGivenName": "san",
"personFamilyName": "zhang",
"sex": "1"
},
"facePic": {
"faceUrl": "/9j/4AAQSkZJRgABAQEAAAAAAAD/4QBCRXhpZgAATU"
}
}
]
}
}
POST /artemis/api/frs/v1/face/deletion
Remove the information of a face from a specified face comparison group.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/deletion
Request Parameters

Type
'/\:*?"<>|
indexCodes Req. Array of String Body Array of person IDs, but
currently, only one ID can be
set in the array. If no ID or
multiple IDs are specified, error
will be returned.
faceGroupInde Req. String Body Face comparison group ID,
xCode which can be obtained by
getting face comparison group
by condition.
deleteFromOr Opt. String Body Whether to remove from the
g organization: "0" or null-no,
"1"-yes.
214
Request Example
{
"indexCodes": [
"4"
],
"deleteFromOrg":"0"
}
Response Parameters

characters.
field is null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/frs/v1/face/single/addition
Add the information of a face.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/face/single/addition
215
Request Parameters

Type
'/\:*?"<>|
personIndexC Opt. String Body Person ID in the person list, if
ode this field is configured, the
person to be added is from the
person list, and the fields
faceInfo and facePic are
invalid.
faceGroupInde Req. String Body ID of face comparison group
xCode that the face information to be
added to. The ID can be
obtained by getting face
comparison group by
condition.
faceInfo Opt. Object Body Face information. See details in
FaceInfo .
facePic Req. Object Body Face picture data. See details in
facePic .
Request Example
{
"personIndexCode": "1",
"faceInfo": {
"personGivenName": "san",
"personFamilyName": "zhang",
"sex": "1"
},
"facePic": {
"faceBinaryData": "/9j/4AAQSkZJRgABAQEAAAAAAAD/4QBCRXhpZgAATU"
}
}
216
Response Parameters

characters.
data Req. Object Response data details.
indexCode Req. String Face ID.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"indexCode": "4"
}
}
5.3.11 Alarm Input/Output Information
POST /artemis/api/resource/v1/alarmInput/advance/alarmInputList
Set search condition (input alarm name, device ID, area ID, etc.) to search for the alarm input
information; if the search condition is not configured, all alarm input information will be returned
by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmInput/advance/alarmInputList
217
Request Parameters

Type
'/\:*?"<>|
500.
alarmInputNa Opt. String Body Alarm input name, which
me consists of up to 32 characters,
items.
devIndexCode Opt. String Body Device ID, which consists of up
to 64 characters. If the ID is
specified, only the cameras of
the current level will be
searched for.
de 64 characters.
Request Example
{
"pageNo": 1,
"pageSize": 2,
"alarmInputName": "D1_0.0.0.0",
}
218
Response Parameters

characters.
list Opt. Array Alarm input information list.
list[0] Opt. Object A specific alarm input information.
See details in AlarmInputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"alarmInputIndexCode": "1215",
"networkStatus": 2
}
]
}
}
219
POST /artemis/api/resource/v1/alarmInputs
Get the alarm input information list, and all the information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmInputs
Request Parameters

Type
'/\:*?"<>|
500.
items.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

220

characters.
list Opt. Array Alarm input information list.
list[0] Opt. Object Specific alarm input information. See
details in AlarmInputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 129,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"networkStatus": 2
},
{
"alarmInputName": "A1",
"networkStatus": 2
}
]
221
}
}
POST /artemis/api/resource/v1/alarmInputs/indexCode
Get the alarm input information according to alarm input ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmInputs/indexCode
Request Parameters

Type
'/\:*?"<>|
alarmInputInd Req. String Body Alarm input ID, which consists
exCode of up to 64 characters.
Request Example
{
"alarmInputIndexCode": "1215"
}
Response Parameters

characters.
222

data Opt. Object Alarm input information. See details
in AlarmInputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"networkStatus": 2
}
}
POST /artemis/api/resource/v1/alarmOutput/advance/alarmOutputList
Set search condition (output alarm name, device ID, area ID, etc.) to search for the alarm output
information; if the search condition is not configured, all alarm output information will be returned
by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmOuput/advance/
alarmOutputList
Request Parameters

Type
'/\:*?"<>|
223

Type
500.
alarmOutputN Opt. String Body Alarm output name, which
ame consists of up to 32 characters,
items.
devIndexCode Opt. String Body Device ID, which consists of up
to 64 characters. If the ID is
specified, only the cameras of
the current level will be
searched for.
de 64 characters.
Request Example
{
"pageNo": 1,
"pageSize": 10,
"alarmOutputName": "0.0.0.0",
}
Response Parameters

224

characters.
list Opt. Array Alarm output information list.
list[0] Opt. Object A specific alarm output information.
See details in AlarmOutputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"alarmOutputIndexCode": "1218",
"alarmOutputName": "D2_0.0.0.0",
"status": -1
},
{
"status": -1
}
]
225
}
}
POST /artemis/api/resource/v1/alarmOutput/controlling
Control alarm output.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmOutput/controlling
Request Parameters

Type
'/\:*?"<>|
alarmOutputI Req. String Body Alarm output ID, which consists
ndexCode of up to 64 characters.
action Req. Number Body Operation: 0-disable alarm
output, 1-enable alarm output.
Request Example
{
"action": 1
}
Response Parameters

characters.
226

Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
POST /artemis/api/resource/v1/alarmOutputs
Get the alarm output information list, and all the information is returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmOutputs
Request Parameters

Type
'/\:*?"<>|
500.
227

Type
items.
Request Example
{
"pageNo": 1,
"pageSize": 2
}
Response Parameters

characters.
list Opt. Array Alarm output information list.
list[0] Opt. Object Specific alarm output information.
See details in AlarmOutputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 81,
228
"pageNo": 1,
"pageSize": 2,
"list": [
{
"status": -1
},
{
"status": -1
}
]
}
}
POST /artemis/api/resource/v1/alarmOutputs/indexCode
Get the alarm output information according to alarm output ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/resource/v1/alarmOutputs/indexCode
Request Parameters

Type
'/\:*?"<>|
alarmOutputI Req. String Body Alarm output ID, which consists
229
Request Example
{
"alarmOutputIndexCode": "1218"
}
Response Parameters

characters.
data Opt. Object Alarm output information. See details
in AlarmOutputInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"status": -1
}
}
5.4 Video API

Here provides APIs for getting streaming URL for live view, playback, and two-way audio, preset
management, patrol management, PTZ control, getting real-time people counting statistics, and so
on.
230
5.4.1 POST /artemis/api/aiapplication/v1/people/statisticsTotalNumByTime

Get people counting statistics of a specified camera by minute, hour, day, and month.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/aiapplication/v1/people/
statisticsTotalNumByTime
Request Parameters

Type
' / \ : * ? " < > |.
500.
cameraIndexC Req. String Body Camera ID, and the maximum
odes length is 1024 bytes. For
multiple IDs, each two ones
should be separated by comma
and up to 10 IDs are allowed.
statisticsType Req. Number Body Statistics type: 0-by hour, 1-by
day, 2-by month, 4-by minute.
startTime Req. String Body Start time in ISO 8601 format
of search, which is represented
by "yyyy-MM-ddTHH:mm:ss
"2018-07-26T15:00:00+08:00".
bytes.
endTime Req. String Body End time in ISO 8601 format of
search, which is represented by
"yyyy-MM-ddTHH:mm:ss
231

Type
"2018-07-26T15:00:00+08:00".
bytes.
Request Example
{
"pageNo": 1,
"pageSize": 20,
"cameraIndexCodes": "1",
"statisticsType": 0,
"startTime": "2018-07-26T15:00:00+08:00",
"endTime": "2018-07-26T16:00:00+08:00"
}
Response Parameters

characters.
completeness Opt. Number Whether the data is complete: 0-no,
1-yes.
list Opt. Array People counting statistics list.
list[0] Opt. Object People counting statistics of an item
in the list. See details in
PeopleCountInfo .
232
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"completeness": 1,
"pageNo": 1,
"pageSize": 20,
"list": [
{
"time": "2018-07-26T15:00:00+08:00",
"exitNum": 5,
"enterNum": 1
}
]
}
}
5.4.2 POST /artemis/api/aiapplication/v1/people/resourceGroupRealTimeCount

Get the real-time statistics of resource groups.
Request URL
resourceGroupRealTimeCount
Request Parameters

Type
'/\:*?"<>|
resourceGrou Req. String Body Resource group ID, the
pIndexCodes maximum length is 1024
characters. Up to 10 group IDs
are allowed. Use comma to
separate different IDs.
233
Request Example
{
"resourceGroupIndexCodes":"1"
}
Response Parameters

characters.
list Opt. Array List of the real-time statistics of
resource groups.
list[0] Opt. RealPeopleCountI The real-time statistics of a resource
nfo group.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"list":[{
"time":"2018-07-26T15:00:00+08:00",
"exitNum":5,
"enterNum":1
}]
}
}
234
5.4.3 POST /artemis/api/aiapplication/v1/people/advance/resourceGroupList

Get the list of resource groups.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/aiapplication/v1/people/advance/
resourceGroupList
Request Parameters

Type
'/\:*?"<>|
500.
64 characters.
name Opt. String Body Name of the resource group.
resourceGrou Opt. String Body Resource group ID. Use comma
pIndexCodes to separate different IDs.
Request Example
{
"pageNo": 1,
"pageSize": 10
}
Response Parameters

235

characters.
total Opt. Number Total number of matched results, the
list Opt. Array List of resource groups.
list[0] Opt. ResourceGroupInf Information about a resource group.
o
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":2,
"pageNo":1,
"pageSize":10,
"list":
}
}
5.4.4 POST /artemis/api/aiapplication/v1/people/statisticsHeatMapByTime

Get the heat map information of a specific camera.
236
Request URL
statisticsHeatMapByTime
Request Parameters

Type
'/\:*?"<>|
statisticsType Req. Number Body Heat map type: 0 (dwell
duration), 1 (number of
people).
beginTime Req. String Body Start time of search, in ISO
8601 format, which is
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
endTime Req. String Body End time of search, in ISO 8601
"2018-07- 26T15:00:00
+ 08:00". The maximum length
is 64 bytes.
Request Example
{
"statisticsType": 0,
"beginTime": "2022-02-16T15:00:00+08:00",
"endTime": "2022-02-16T16:00:00+08:00"
}
237
Response Parameters

characters.

maxValue Req. Number The maximum heat value.
minValue Req. Number The minimum heat value.
arrayLine Req. Number Average heat value.
arrayLine Req. Number Row value of map pixels. When this
field is 0, the pixel data information
does not exist.
arrayColum Req. Number Column value of map pixels. When
this field is 0, the pixel data
information does not exist.
buffer Opt. String Heat map pixel data information
(base64).
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"maxValue": -1,
"minValue": -1,
"averageValue": -1,
238
"arrayLine": -1,
"arrayColum": -1,
"buffer": ""
}
}
5.4.5 POST /artemis/api/video/v1/cameras/playbackURLs

Get the streaming URL for playback via protocols including RTSP, RTSP_S, WebSocket,
WebSocket_S, RTMP (H.264 video encoding only), and HLS (Cloud Storage 2.2.8 above and CVR
3.2.8 above; H.264 video encoding only). Audio playback via HLS and RTMP only supports
Advanced Audio Coding (ACC). During playback by RTSP_s, RTMP or HLS, follow the following
format: URL +
"&beginTime=2022-06-24T22:59:48.000-07:00&endTime=2022-06-25T00:46:36.000-07:00".
Note
Supports DST in ISO 8601 format, which is represented by "yyyy- MMddTHH: mm:ss+current time
difference". When you search by device time,
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/cameras/playbackURLs
Request Parameters

Type
'/\:*?"<>|
domainId Opt. Number Header Domain ID.
recordType Req. String Body Recording types, i.e., "0" (main
recording) and "1" (auxiliary
recording). And this field can
contain up to 32 characters.
protocol Opt. String Body Streaming protocol (application
layer protocol) types: "rtsp"
(default) and "websocket" (for
239

Type
JsDecoder SDK), "rtsp_s" (for
getting stream via standard
RTSP), "websocket_s", "hls",
"rtmp". And this field can
transmode Opt. Number Body Transfer protocol types: 0-UDP,
1-TCP (default). And this field is
valid when the protocol is set
to "rtsp".
beginTime Req. String Body Start time of search, which is in
yyyy-MM-
2018-07-26T15:00:00 + 08:00.
64 characters.
yyyy-MM-
2018-07-26T15:00:00 + 08:00.
64 characters.
uuid Opt. String Body ID for searching by page, which
This UUID is returned after the
previous search and it is used
for the next search of
remaining videos. By default, it
is "null".
requestWebso Opt. Number Body Streaming type of websocket:
cketProtocol 0-ws, 1-wss. This parameter is
required when the value of
protocol is "websocket".
240
Note
The days between start time and end time should be no more than three days.
Request Example
{
"beginTime":"2021-04-26T00:00:00+08:00",
"endTime":"2021-04-26T01:00:00+08:00",
"recordType":"0",
"protocol":"rtsp",
"transmode":"1",
"uuid":""
}
Response Parameters

characters.
data Opt. Object Playback URL and video segment
information. See details in
PlaybackUrlVideoInfo and VideoInfo .
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"url":"[sms:playback]rtsp://10.41.13.178:554/file/dvr://10.41.7.143:8001/0/channels/33?tcpport=10000",
"authentication":"J3mnUxvJ4vcJ5vdN25FrX/Xru/
5fhLD7DbVcYjWNobrt6NhHuwqYwWxulqfWcFPWhRyeWPi7V4bqkbEiVj9NEuRyrx5VkgoZRF9vrR6MJAcRef96KJfnBEdfKg
VbPBOsF4nSeIxElU5oEE2dBWJMsRKETW7QAhMQXcB2e/SY6NXcHZ/QmE4v27j3H2Y3eJWvjrFwfMSITcThZJPhv1nLGYz
+BVo+zSTKaVX6VP3DeTeiDpQtX0Dvq82+zyAyNBVVehAht3QKVf5DCOsr8o65o8HEEdq+e/
mvrZ4N3EcxadJrMcJmbtIn2YKm7SAbxrCQw2hrnwwDhi0nKYSJJSzfvA==",
241
"uuid":"",
"recordLocation":1
}
}
5.4.6 POST /artemis/api/video/v1/cameras/previewURLs

Get the streaming URL for live view via protocols including RTSP, RTSP_S, WebSocket,
WebSocket_S, RTMP, and HLS. Streaming via RTMP and HLS only supports H.264 video encoding.
Audio streaming only supports Advanced Audio Coding (ACC).
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/cameras/previewURLs
Request Parameters

Type
'/\:*?"<>|
streamType Opt. Number Body Stream types: 0-main stream
(default), 1-sub-stream.
(default), "websocket" (for
242

Type
1-TCP (default).
requestWebso Opt. Number Body Streaming type of websocket:
cketProtocol 0-ws, 1-wss. This parameter is
protocol is "websocket".
Request Example
{
"streamType":0,
"protocol":"rtsp",
"transmode":1
}
Response Parameters

characters.
data Opt. Object Live view URL information. See details
in LiveViewUrlInfo .
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"url":"[sms:preview]rtsp://10.41.13.178:554/hikvision://10.41.7.66:8001:0:0",
"authentication":"Fsd8eugj2+RYG6EKEgN8/EHy6o5XPdkxD8t7Dy+EH6moE4G0X9+60C7PucJ8TlZOJHpXlM0y
243
+DwPdkSiALHgLmcWShmtWnKnfD5lhfDSMakMUxtlqfqOalXw5AAcSxoz76LkR8qzI8lKncuhXO9RslvYiC0UJN/
b3tmwUH999oWgJbX6jd3mN/p3FPgi4NtkbADKKnmjEY8NI9cPDcHaMfV+oJCYF0aVCjI3BU9AnPY="
}
}
5.4.7 POST /artemis/api/video/v2/cameras/previewURLs

Batch get streaming URLs for live view via protocols including RTSP, RTSP_S, WebSocket,
WebSocket_S, RTMP, and HLS. Streaming via RTMP and HLS only supports H.264 video encoding.
Audio streaming only supports Advanced Audio Coding (ACC).
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v2/cameras/previewURLs
Request Parameters

Type
'/\:*?"<>|
cameraIndexC Req. String Body Camera IDs, which consist of up
odes to 1024 characters.
streamType Opt. Number Body Stream types: 0-main stream
(default), 1-sub-stream. And
this field can contain up to 32
characters.
(default), "websocket" (for
1-TCP (default). And this field
244

Type
can contain up to 32
characters.
Request Example
{
"streamType":0,
"protocol":"rtsp",
"transmode":1,
}
Response Parameters

characters.
data Opt. Object Live view URL information. See details
in LiveViewUrlInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"list": [
{
"url": "[sms:preview]rtsp://10.19.131.67:554/hikvision://10.14.67.204:8000:0:0?bandwidth=4",
"authentication": "Fsd8eugj2+RYG6EKEgN8/EHy6o5XPdkxD8t7Dy
+EH6n0ECvzdKuvVH5xFnTYOEuACuTyjZTCemXqQf6bzYDmvszxZmoGM2j/b2EzE
+96DduQT2+tt4jaSxWVkPcEHIi3lH6kWp/EerFa/TKSolhIuDk3nw7QoNMKLOsJpCqizP/
OIHr8Qv6L0cJoFBw8KSd9J6APaTb7I9dHVStExL/R6NHmNBH9dfJcSgKOCEQRz9A="
},
245
{
"url": "[sms:preview]rtsp://10.19.131.67:554/hikvision://10.41.7.98:8089:0:0?bandwidth=2",
"authentication": "J3mnUxvJ4vcJ5vdN25FrXxtO+7SQkYajdcztnn8uDbQ3XXPpnNaZjVNzzmf84oM3tO/
TzJUoEh3SEXJfcADJK0XlpPUAFNxNVbO2N5Wx1ueJwIoQ94oxWjBNqcUfgqdww/jc27BGG6U8J
+FvLPoi0GMtbn93I50+LBinpwPAn9T5M
+NyTyU7mwGUKjKcaE5auVkGQ8wSh1VJSNvEyChctp8OjU4ldY8RWMLS1WWoBSk="
}
]
}
}
5.4.8 POST /artemis/api/video/v1/cameras/talkURLs

Get streaming URL of two-way audio for the camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/cameras/talkURLs
Request Parameters

Type
'/\:*?"<>|
(default),"websocket_s". And
characters.
characters.
246
Request Example
{
"transmode": 1
}
Response Parameters

characters.
data Opt. Object Two-way audio URL information.
Refer to TwoWayAudioUrlInfo for
details.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"url":"[sms:voicetalk]rtsp://10.41.13.178:554/voicetalk://10.41.7.66:8001:0:0",
}
}
5.4.9 POST /artemis/api/video/v1/device/talkURLs

Get streaming URL of two-way audio for the device.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/device/talkURLs
247
Request Parameters

Type
'/\:*?"<>|
(default), "websocket_s". And
characters.
characters.
Request Example
{
"transmode": 1
}
Response Parameters

characters.
248

data Opt. Object Two-way audio URL information.
Refer to TwoWayAudioUrlInfo for
details.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"url":"[sms:voicetalk]rtsp://10.41.13.178:554/voicetalk://10.41.7.66:8001:0:0",
}
}
5.4.10 POST /artemis/api/video/v1/patrols/addition

Add a patrol to a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/patrols/addition
Request Parameters

Type
'/\:*?"<>|
patrolName Opt. String Body Patrol name, which consists of
249

Type
patrolIndex Req. Number Body Patrol No., which ranges from 1
to 8. And the No. consists of up
to 64 characters.
patrolPointInf Req. Array Body Preset information list of the
oList patrol.
patrolPointInf Req. Object Body Information of a preset in the
oList[0] preset list of the patrol. Refer
to PatrolPointInfo for details.
Request Example
{
"patrolIndex": 1,
"patrolName": "1",
"patrolPointInfoList": [
{
"presetIndex": 1,
"speed": 1,
"dwellTime": 15
}
]
}
Response Parameters

characters.
data Opt. / Set it to null.
250
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.4.11 POST /artemis/api/video/v1/patrols/deletion

Delete a patrol of a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/patrols/deletion
Request Parameters

Type
'/\:*?"<>|
patrolIndex Req. Number Body Patrol No., which ranges from 1
to 8. And the No. consists of up
to 64 characters.
Request Example
{
"patrolIndex":1
}
Response Parameters

251

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.4.12 POST /artemis/api/video/v1/patrols/patrolIndex/patrolInfo

Get the patrol information of a camera by patrol No.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/patrols/patrolIndex/patrolInfo
Request Parameters

Type
'/\:*?"<>|
patrolIndex Req. Number Body Patrol No., which consists of up
to 64 characters.
252
Request Example
{
"patrolIndex": 1
}
Response Parameters

characters.
data Opt. Object Patrol information. See details in
PatrolInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"patrolIndex": 1,
"patrolName": "1"
}
}
5.4.13 POST /artemis/api/video/v1/patrols/searches

Search for the patrol information of a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/patrols/searches
253
Request Parameters

Type
'/\:*?"<>|
Request Example
{
}
Response Parameters

characters.
list Opt. Array Patrol information list.
list[0] Opt. Object Information of a patrol in the list.
Refer to PatrolInfo for details.
Response Example
{
"code": "0",
254
"msg": "Success",
"data": {
"total": 1,
"list": [
{
"patrolName": "1",
"patrolIndex": 1
}
]
}
}
5.4.14 POST /artemis/api/video/v1/presets/addition

Add a preset to a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/presets/addition
Request Parameters

Type
'/\:*?"<>|
presetName Req. String Body Preset name, which can be
duplicated. And it consists up
presetIndex Req. Number Body Preset No., which ranges from
1 to 256. And the No. consists
Request Example
{
"presetName":"2",
"presetIndex":2
}
255
Response Parameters

characters.
data Opt. Set it to null.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.4.15 POST /artemis/api/video/v1/presets/deletion

Delete a preset of a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/presets/deletion
Request Parameters

Type
256

Type
'/\:*?"<>|
presetIndex Req. Number Body Preset No., which ranges from
1 to 256. And each No. consists
Request Example
{
"presetIndex":1
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
257
5.4.16 POST /artemis/api/video/v1/presets/searches

Search for the preset information of a camera.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/presets/searches
Request Parameters

Type
'/\:*?"<>|
Request Example
{
}
Response Parameters

characters.
258

list Opt. Array Preset information list.
list[0] Opt. Object Information of a preset in the list.
Refer to PresetInfo for details.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"list": [
{
"presetName": "1",
"presetIndex": 1
}
]
}
}
5.4.17 POST /artemis/api/video/v1/ptzs/controlling

Control the PTZ after starting live view.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/ptzs/controlling
Request Parameters

Type
'/\:*?"<>|
action Req. Number Body Start or stop control: 0-start, 1-
stop.
259

Type
command Req. String Body PTZ control commands (case
insensitive): "LEFT" (pan left),
"RIGHT" (pan right), "UP" (tilt
up), "DOWN" (tilt down),
"ZOOM_IN" (zoom in),
"ZOOM_OUT" (zoom out),
"LEFT_UP" (pan left and tilt
up), "LEFT_DOWN" (pan left
and tilt down), "RIGHT_UP"
(pan right and tilt up), "RIGHT_
DOWN" (pan right and tilt
down), "FOCUS_NEAR" (focus
+), "FOUCS_FAR" (focus -),
"IRIS_ENLARGE" (iris +), "IRIS_
REDUCE" (iris -), "GOTO_
PRESET" (call preset), and
"RUN_PATROL" (call patrol).
The field can contain up to 16
characters.
speed Opt. Number Body PTZ control speed, which
ranges from 20 and 60, and the
default speed is 40.
Note
This field is Opt. only when the
control commands are
"GOTO_PRESET" and "RUN_
PATROL". For other
commands, this field is Req..
presetIndex Opt. Number Body Preset No., which ranges from

1 to 256.
260

Type
Note
This field is Req. when the
control command is "GOTO_
PRESET".
patrolIndex Opt. Number Body Patrol No., which ranges from 1

to 8.
Note
This field is Req. when the
control command is "RUN_
PATROL".
Request Example
{
"command": "GOTO_PRESET",
"presetIndex":1,
"action": 0,
"speed": 40,
"PatrolIndex": 1
}
Response Parameters

characters.
261
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.4.18 POST /artemis/api/video/v1/camera/capture

Capture real-time pictures via camera. The resolution is determined by the device environment.
For devices accessed via EHOME protocol, picture capture depends on the device capability and if
the picture storage has been enabled and configured.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/camera/capture
Request Parameters

Type
'/\:*?"<>|
Request Example
{
}
Response Parameters

262

characters.
data Opt. String Returned picture information
encoded by Base64.
Response Example
{
"code": "0",
"msg": "Success",
"data": “data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/
2wBDAAYEBAUEBAYFBQUHBgYHCRAKCQgICRMODgsQFxQYGBYUFhYZHCQfGRsiGxYWICsgIiYnKSkpGB4tMCwoMCQoKSf
/2wBDAQYHBwkICRIKChInGhYaJycnJycnJycnJycnJycnJycnJycnJycnJycnJycnJy”
}
5.4.19 POST /artemis/api/video/v1/download

Download recordings by obtained playback URL, authentication information, start and end time,
and video format.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/download
Request Parameters

Type
'/\:*?"<>|
url Req. String Body Playback URL, obtained via
POST /artemis/api/video/v1/
cameras/playbackURLs .
263

Type
authentication Req. String Body Authentication information for
streaming, obtained via POST /
artemis/api/video/v1/
cameras/playbackURLs .
beginTime Req. String Body Start time of the recording, in
represented by "yyyy-
MMddTHH: mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
maximum length is 64.
endTime Req. String Body End time of the recording, in
represented by "yyyy-
MMddTHH: mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
videoType Opt. Number Body Video format: 0-AVI (default),
1-MP4.
Request Example
{
"url": "rtsp://10.18.66.12:554/sms/HCPEurl/commonvideobiz_yL3BB0IJEfmZXqcbVjpen
%2BT1uYbybvT38kqzRR6XaakK2GcRosSrw4A9o%2FFtIeHzaYm3O%2Fmn
%2FWOZwbiNhwhk9eTw1oiI8YFyIY5tLp5CJu7RnoINpei1W22NqnwyDt
%2FcnLNZEnXoejzLazu9A0oXWVwxjsV99%2FtZXqJx8K7601%2BywBbErC80PzfVyFWd5HKmEz8NVdNCVT2fqokL8868ffQ
i8uMYNLXYSE0FEsqunLs%3D",
"authentication": "Fsd8eugj2+RYG6EKEgN8/EHy6o5XPdkxD8t7Dy
+EH6moE4G0X9+60C7PucJ8TlZOdGIK3lH5W7JDFdrercIsiJb1bl9Y52PGA/K/QXIff+84XMQ=",
"beginTime": "2022-09-07T19:38:16+08:00",
"endTime": "2022-09-07T19:38:16+08:00",
"videoType": 1
}
264
Response Parameters

characters.
data Opt. PageInfo Download information structure.
Table 5-1 PageInfo Object Description

downID Req. String Download ID (valid for 10 minutes).
Get download progress and
download URL by the download ID.
The maximum length is 32.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"downID": "F704686D84CD4E34A2181A915862FE3F"
}
}
5.4.20 POST /artemis/api/video/v1/downloadURL

Get download progress and download URL by the download ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/downloadURL
265
Request Parameters

Type
userId Opt. String Header User ID, which consists of 1 to 32
special characters like ' / \ : * ? "
<>|
downloadID Req. Number Header Obtained from POST /
artemis/api/video/v1/
download . The maximum
length is 32.
Request Example
{
"downloadID": "1"
}
Response Parameters

characters.
data Opt. PageInfo Download information structure.
266

percent Req. String Download progress (unit: %). The
url Opt. String Download URL.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"percent": "1",
"url": "http://10.18.66.12/download/20221017204905_F704686D84CD4E34A2181A915862FE3F.avi"
}
}
5.4.21 POST /artemis/api/video/v1/event/searchLabels

Get the tags of the person/vehicle-detected videos recorded by cameras.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/video/v1/event/searchLabels
Request Parameters

Type
'/\:*?"<>|
pageNo Req. Number Body The current page No. The
page. The maximum length is
32.
267

Type
yyyy-MMdd'T'HH:
mm:ss.SSSzzz, e.g., 2018-07-
26T15:00:00 + 08:00. And the
time consists of up to 64
characters.
yyyy-MMdd'T'HH:
26T15:00:00 + 08:00. And the
characters.
eventLabel Req. Enum Body 1 (person/vehicle-detection
tag), 2 (person-detection tag), 4
(vehicle-detection tag).
Request Example
{
"pageNo": 1,
"pageSize": 2,
"startTime": "2022-08-06T09:58:39+08:00",
"endTime": "2022-08-06T09:58:39+08:00",
"eventLabel": 1
}
Response Parameters

268

characters.
data Opt. PageInfo Structure for getting the tag.

totalNum Req. Number Number of tags. The maximum length
is 32.
pageNo Req. Number The current page No. The maximum
length is 32.
pageSize Req. Number Number of records on each page. The
labelList Opt. labelListInfo[] Get the list of event tags. See details
in eventLabelList .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"totalNum": 8,
"pageNo": 1,
"pageSize": 100,
"labelList": [
"labelCode": "35",
"labelEvent": 2,
"startTime": "2022-10-20T15:56:13+08:00",
"endTime": "2022-10-20T15:56:23+08:00"
]
}
}
269
5.5 Alarm and Event API

Here provides APIs for event and alarm search, getting event and alarm picture, alarm
acknowledgment, event subscription, generic event rule management, and so on.
5.5.1 POST /artemis/api/eventService/v1/eventRecords/controlling

Acknowledge the alarm.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/eventRecords/controlling
Request Parameters

Type
'/\:*?"<>|
eventIndexCo Req. String Body Event ID, which consists of up
de to 64 characters.
controlType Req. Number Body Operation type: 1-acknowledge
alarm
Request Example
{
"eventIndexCodes":"1f276203e5234bdca08f7d99e1097bba",
"controlType":1
}
Response Parameters

270

Each code contains up to 32
characters.
details. Each description contains up
to 256 characters.
data Opt. String No data returned.
Response Example
{
"code":"0",
"msg":"Success",
"data":""
}
5.5.2 POST /artemis/api/eventService/v1/eventRecords/page

Set search conditions (e.g., event ID, event source, event type, etc.) to search for alarm or event
details, and the search results will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/eventRecords/page
Request Parameters

Type
'/\:*?"<>|
eventIndexCo Opt. String Body Event ID, which consists of up
de to 64 characters. If this field is
not configured, the
eventTypes, srcType, or
271

Type
srcIndexs fields must be
configured.
eventTypes Req. String Body Event type, which can be
separated by comma if there
are multiple types, refer to
Event Types or Alarm
Categories for details. And the
field can contain up to 1024
characters.
srcType Req. String Body Event source type: "acsDevice"
(access controller), "door"
(access point), "encodeDevice"
(encoding device), "camera",
"ioIn" (alarm input),
"generalEventRule" (general
event). And the field can
Refer to Event Types or Alarm
Categories for details.
srcIndexs Req. String Body Event source No., which can be
separated by command if there
are multiple No.s. And the No.
consists of up to 1024
characters.
subSrcType Opt. String Body Event source type, which is
available for license plate
matched or mismatched event
search. The maximum length is
64 bytes. Refer to Event Types
or Alarm Categories for details.
subSrcIndexs Opt. String Body Event source No., which is
available for license plate
matched or mismatched event
search. Each two No. should be
separated by comma. The
272

Type
yyyy-MM-ddTHH:mm:ss
+current zone, e.g., 2018-07-
26T15:00:00+08:00. And the
time contains up to 64
characters.
yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00. And the
time contains up to 64
characters.
500.
Note
The days between start time and end time should be no more than 31 days.
Request Example
{
"eventIndexCode": "12321432154316547",
"eventTypes": "131329",
"srcType": "camera",
"srcIndexs": "1",
"startTime": "2018-07-26T15:00:00+08:00",
"endTime": "2018-07-26T16:00:00+08:00",
"pageNo": 1,
"pageSize": 15
}
273
Response Parameters

characters.
list Opt. Array Event record list.
list[0] Opt. Object Information of an event record in the
list. See details in EventRecord .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total":1,
"pageNo":1,
"pageSize":15,
"list": [
{
"eventIndexCode": "12321432154316547",
"eventType": "131329",
"srcType": "camera",
"srcIndex": "1",
"description": "abc",
"startTime": "2018-07-26T15:00:00+08:00",
"stopTime": "2018-07-26T16:00:00+08:00",
"eventPicUri": "0B4E92A30AF914C1285613A4FBD9F761F ",
"linkCameraIndexCode": "2"
}
274
]
}
}
5.5.3 POST /artemis/api/eventService/v1/eventSubscriptionByEventTypes

Subscribe the events by event type. Repeated subscriptions from the same user will be
automatically deduplicated by the API; when errors occur within the OpenAPI service, the event
will be subscribed again for the partner after the restart of the OpenAPI service. Event subscription
is available for alarm event, on-board monitoring, face picture match, access control card swiping,
not available for vehicle.
Note
After the event callback is enabled, there might be exceptions in 3 circumstances.
● OpenAPI exception: Restart the OpenAPI service and the event records during the exception
period will be pushed from the HikCentral Professional platform to the partner again.
● Third party service or network exception: The pushed events (max. number: 500) will be cached
by OpenAPI for 1 day at most.

● HikCentral Professional exception: Pushing events is not supported.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/eventSubscriptionByEventTypes
Request URL
Request Parameters

Type
'/\:*?"<>|
eventTypes Req. Number Body Event type code, which is a
decimal integer, refer to Event
Types or Alarm Categories for
details. Up to 256 types are
supported, whose codes are
between 100000 and
2147483647.
275

Type
eventDest Req. String Body Address to receive event
information, which consists of
up to 1024 characters. The
address adopts RESTful callback
mode, and supports HTTP and
HTTPS, its format is "http://
ip:port/eventRcv" or "https://
ip:port/eventRcv".
Note
Refer to Event Message
Format for the event details
received in the address.
passBack Opt. Number Body Whether to enable event

callback: 0-no (by default), 1-
yes.
Request Example
{
"eventTypes":[131329,131330,131331],
"eventDest":"https://10.18.66.21:8080/eventRcv"
}
Response Parameters

characters.
to 256 characters.
276
Response Example
{
"code": 0,
"msg": "Success"
}
5.5.4 POST /artemis/api/eventService/v1/eventSubscriptionView

Search for event subscription details by user.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/eventSubscriptionView
Request Parameters

Type
'/\:*?"<>|
Request Example
uri：/api/eventService/v1/eventSubscriptionView
Response Parameters

characters.
277

to 256 characters.
data Opt. Detail Response data details.
Table 5-4 Detail Object Description

detail Req. SubscriptionInfo[] Details of a subscribed event. Refer to
SubscriptionInfo for details.
Response Example
{
"code": 0,
"msg": “Success”,
"data": {
"detail":
[
{
"eventTypes":[131329,131330,131331],
"eventDest":" https://10.18.66.21:8080 /eventRcv ",
"passBack":0
}
]
}
}
5.5.5 POST /artemis/api/eventService/v1/eventUnSubscriptionByEventTypes

Cancel subscribing events by event type.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/
eventUnSubscriptionByEventTypes
278
Request Parameters

Type
'/\:*?"<>|
eventTypes Req. Number Body Event type code, which is a
details. Up to 256 types are
supported, whose codes are
between 100000 and
2147483647.
Request Example
{
"eventTypes":[131329,131330,131331]
}
Response Parameters

characters.
to 256 characters.
Response Example
{
"code": 0,
279
"msg": "Success",
}
5.5.6 POST /artemis/api/eventService/v1/generalEventRule/generalEventRuleList

Get the information list of generic events.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/generalEventRule/
generalEventRuleList
Request Parameters

Type
'/\:*?"<>|
500.
Request Example
{
"pageNo": 1,
"pageSize": 1
}
Response Parameters

280

characters.
list Opt. Array Information list of generic events.
list[0] Opt. Object Information about a specific generic
event. See details in
GeneralEventRule .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 3,
"pageNo": 1,
"pageSize": 1,
"list": [
{
"generalEventRuleIndexCode": "1",
"generalEventRuleName": "1",
"transportType": 0,
"matchType": 0,
"expression": "\"1\" AND \"1\"",
"regularExpression": "(1.*1|1.*1)"
}
]
}
}
281
5.5.7 POST /artemis/api/eventService/v1/generalEventRule/single/add

Customize the expression to add a generic event.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/generalEventRule/single/add
Request Parameters

Type
'/\:*?"<>|
generalEventR Req. String Body Name of the generic event,
uleName which consists of up to 32
characters.
transportType Req. Number Body Transmission type: 0-TCP, 1-
UDP. The maximum length is 32
characters.
matchType Req. Number Body Match type: 0-search (the
received data package must
contain the text specified in
expression, but may also have
more content), 1-match (the
contain exactly the text
specified in expression, and
nothing else). The maximum
expression Req. String Body Description of the regular
expression, which consists of
regularExpress Req. String Body Regular expression of the
ion generic event, which consists
282
Request Example
{
"generalEventRuleName": "name1",
"transportType": 0,
"matchType": 0,
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.5.8 POST /artemis/api/eventService/v1/generalEventRule/single/delete

Delete a generic event.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/generalEventRule/single/delete
283
Request Parameters

Type
'/\:*?"<>|
generalEventR Req. String Body Generic event ID, which
uleIndexCode consists of up to 64 characters.
Request Example
{
"generalEventRuleIndexCode": "1"
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
284
5.5.9 POST /artemis/api/eventService/v1/generalEventRule/single/update

Edit a generic event.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/generalEventRule/single/update
Request Parameters

Type
'/\:*?"<>|
generalEventR Req. String Body Generic event ID, which
uleIndexCode consists of up to 64 characters.
generalEventR Req. String Body Generic event name, which
uleName consists of up to 32 characters.
transportType Req. Number Body Transmission type: 0-TCP, 1-
UDP. The maximum length is 32
characters.
matchType Req. Number Body Match type: 0-search (the
contain the text specified in
expression, but may also have
more content), 1-match (the
contain exactly the text
specified in expression, and
nothing else). The maximum
expression Req. String Body Description of the regular
expression, which consists of
regularExpress Req. String Body Regular expression of the
ion generic event, which consists
285
Request Example
{
"generalEventRuleIndexCode": "1",
"generalEventRuleName": "name2",
"transportType": 0,
"matchType": 0,
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.5.10 POST /artemis/api/eventService/v1/generalEventRule/triggerAlarm

Configure parameters to enable receiving the generic events By default, the recipient is admin and
the linked camera is the one with storage configured.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/generalEventRule/triggerAlarm
286
Request Parameters

Type
'/\:*?"<>|
generalEventR Req. String Body Generic event ID (separate
uleIndexCodes multiple items with comma,
currently only one ID is
supported). The maximum
description Req. String Body Description. The maximum
alarmPriority Req. Number Body Alarm priority: 1-high, 2-
medium, 3-low. The maximum
triggerPopup Opt. Number Body Whether it triggers pop-up
Windows window: 0-no, 1-yes. The
maximum length is 256
characters.
linkCameraList Opt. Array Body List of linked camera.
linkCameraList Opt. Object Body Information of linked camera.
[0]
cameraIndexC Req. String Body Camera ID.
ode
recordType Opt. Number Body Recoding type: 0-main
recording, 1-auxiliary
recording.
defaultPlayTyp Opt. Number Body Default type of video play: 0-
e live view, 1-playback.
Request Example
{
"generalEventRuleIndexCodes": "1",
"description": "descriptioninfo",
"alarmPriority": 1,
287
"triggerPopupWindows": 0,
"linkCameraList": [
{
"recordType": 0
}
],
"defaultPlayType": 0
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.5.11 POST /artemis/api/eventService/v1/image_data

Get alarm pictures from the searched alarm or event information by picture URL.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/image_data
288
Request Parameters

Type
'/\:*?"<>|
domainId Opt. String Header Domain ID, which is used in the
streaming URL and consists of
up to 16 characters. If this field
is not configured, the value will
be determined by the request.
picUri Req. String Body Picture URL, which consists of
Request Example
{
"picUri": "/pic?=d7ei703i10cd*73a-d5108a--22cd0c9d6592aiid="
}
Response Parameters

characters.
to 256 characters.
data Opt. String Binary picture data in the response.
289
Response Example
5.5.12 POST /artemis/api/eventService/v1/deviceApplicationEvent

Search for AIOP and HEOP event lists by condition.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/eventService/v1/deviceApplicationEvent
Request Parameters

Type
'/\:*?"<>|
pageSize Req. String Body Number of records on each
page.
pageIndex Req. String Body The current page No.
criteria Req. Object Body Search conditions, including
event type and event name.
sort Req. Object Body Sort type and sort order.
Table 5-5 criteria Object Description

Type
eventCategory Req. Number Body Event types (100651-HEOP
event, 100652-AIOP event).
eventName Opt. String Body Search by event name. Get all
events when this field is empty.
290
Table 5-6 sort Object Description

Type
sortField Req. String Body Sort by one field: eventName,
rawEventName, or description.
orderType Req. Number Body 0-ascending order, 1-
descending order.
Request Example
{
"pageIndex": 1,
"pageSize": 10,
"criteria": {
"eventCategory": 100652,
"eventName": "name"
},
"sort": {
"sortField": "EventName",
"orderType": 0
}
}
Response Parameters

characters.
to 256 characters.
data Opt. PageInfo Response data.
291

totalNum Req. Number Number of search results from search
by picture for human faces.
pageIndex Req. Number The current page No.
pageSize Req. Number Number of records on each page.
event Req. eventInfo [] Event information. See details in
eventList .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"totalNum": 1,
"pageIndex": 1,
"pageSize": 10,
"event": [
{
"eventCode": 1,
"eventType": 1,
"eventName": "name",
"rawEventName": "rawname",
"description": "test",
"eventCategory": 100652
}
]
}
}
5.6 Visitor API
5.6.1 POST /artemis/api/visitor/v1/appointment

Add a visitor's information for checking in.
Remark
We recommend that you use the API ( POST /artemis/api/visitor/v1/registerment ), which will
take the place of the old one ( POST /artemis/api/visitor/v1/appointment ).
292
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/appointment
Request Parameters

Type
'/\:*?"<>|
receptionistId Opt. String Body ID of the person to be visited,
which consists of up to 64
characters.
visitStartTime Req. String Body Check-in time in ISO 8601
"2018-07- 26T15:00:00
is 64 bytes.
visitEndTime Req. String Body Check-out time in ISO 8601
"2018-07- 26T15:00:00
is 64 bytes. Once the visitor
checked out, all permissions
assigned to this visitor will be
unassigned but the visitor
information will be retained.
visitPurposeTy Req. Number Body Visiting purpose type: 0-
pe business, 1-training, 2-visit, 3-
meeting, 4-others.
visitPurpose Opt. String Body Visiting purpose, which consists
293

Type
visitorInfoList Req. Array Body List of visitor information,
characters.
visitorInfoList[ Req. Object Body A visitor information. See
0] details in VisitorInfo . Currently,
it only supports adding one
visitor at a time.
Request Example
{
"receptionistId": "",
"visitStartTime": "2018-07-26T15:00:00+08:00",
"visitEndTime": "2018-07-26T16:00:00+08:00",
"visitPurposeType": 0,
"visitPurpose": "visitor",
"visitorInfoList": [
{
"VisitorInfo": {
"visitorFamilyName": "san",
"visitorGivenName": "zhang",
"gender": 1,
"email": "999999@qq.com",
"phoneNo": "13600000000",
"plateNo": "A666",
"companyName": "AAA",
"certificateType": 111,
"certificateNo": "null",
"remark": "visitor",
"faces": [
{
"faceData": "/9j/4AAQSkZRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}
],
"fingerPrint": [
{
"fingerPrintData": "46504D228697F1AD0146C8D00",
}
],
"cards": [
{
"cardNo": "123456"
}
294
]
}
}
]
}
Response Parameters

characters.
appointRecordId Opt. String Reservation record ID, which consists
visitorId Opt. String Visitor ID, which consists of up to 64
characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"appointRecordId": "1",
"visitorId":”"2"
}
}
5.6.2 POST /artemis/api/visitor/v1/appointment/update

Edit a visitor's information for checking in. Currently, editing visitors in a batch is not supported.
295
Remark
We recommend that you use the API ( POST /artemis/api/visitor/v1/registerment/update ),
which will take the place of the old one ( POST /artemis/api/visitor/v1/appointment/update ).
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/appointment/update
Request Parameters

Type
'/\:*?"<>|
appointRecord Req. String Body Reservation record ID, which
Id consists of up to 64 characters.
characters.
"2018-07- 26T15:00:00
is 64 bytes.
"2018-07- 26T15:00:00
is 64 bytes. Once the visitor
assigned to this visitor will be
unassigned but the visitor
information will be retained.
296

Type
meeting, 4-others.
visitPurpose Opt. String Body Visiting purpose.
characters.
visitorInfoList[ Req. Object Body Information about a visitor. See
0] details in VisitorInfo .
Request Example
{
"receptionistId": "1",
"visitEndTime": "2018-07-26T16:00:00+08:00",
{
"VisitorInfo": {
"gender": 1,
"email": "null",
"phoneNo": "13600000000",
"plateNo": "BBBA",
"remark": "null",
"faces": [
{
"faceData": "/9j/4AAQSkZJRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}
],
"fingerPrint": [
{
}
297
],
"cards": [
{
"cardNo": "123456"
}
]
}
}
]
}
Response Parameters

characters.
appointRecordId Opt. String Reservation record ID, which will
change each time the visitor
information is updated. The maximum
Response Example
{
"code": "0",
"msg": "Success",
"data":
}
5.6.3 POST /artemis/api/visitor/v1/registerment

Check in a visitor.
298
Remark
We recommend that you use the API ( POST /artemis/api/visitor/v1/registerment ), which will
take the place of the old one ( POST /artemis/api/visitor/v1/appointment ), for checking in a
visitor.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/registerment
Request Parameters

Type
'/\:*?"<>|
characters.
appointId Opt. String Body Reservation record ID, which
visitorId Opt. String Body Visitor ID, which consists of up
to 64 characters.
"2018-07- 26T15:00:00
is 64 characters.
"2018-07- 26T15:00:00
is 64 characters. Once the
visitor checked out, all
permissions assigned to this
299

Type
visitor will be unassigned but
the visitor information will be
retained.
meeting, 4-others.
visitPurpose Opt. String Body Visiting purpose, which consists
characters. Currently, it only
supports adding one visitor at a
time.
Request Example
{
"receptionistId": "",
"visitEndTime": "2018-07-26T16:00:00+08:00",
"visitorInfoList": [{
"VisitorInfo": {
"gender": 1,
"email": "999999@qq.com",
"phoneNo": "13600000000",
"plateNo": "A666",
"remark": "visitor",
"faces": [{
"faceData": "/9j/4AAQSkZRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}],
"fingerPrint": [{
300
}],
"cards": [{
"cardNo": "123456"
}]
}
}]
}
Response Parameters

characters.
qrCodeImage Opt. String Encoded by Base64; represented by
"data:image/png;base64".
characters.
Request Example
{
"code": "0",
"msg": "Success",
"data": {
"visitorId":"2"
"qrCodeImage": "iVBORw0KGgoAAAANSUhEUg”
}
}
301
5.6.4 POST /artemis/api/visitor/v1/registerment/update

Edit a visitor's information for checking in.
Remark
We recommend that you use the API ( POST /artemis/api/visitor/v1/registerment/update ),
which will take the place of the old one ( POST /artemis/api/visitor/v1/appointment/update ).
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/registerment/update
Request Parameters

Type
'/\:*?"<>|
characters.
"2018-07- 26T15:00:00
is 64 characters.
"2018-07- 26T15:00:00
is 64 characters. Once the
visitor checked out, all
permissions assigned to this
302

Type
visitor will be unassigned but
the visitor information will be
retained.
meeting, 4-others.
visitPurpose Opt. String Body Visiting purpose. The maximum
supports editing one visitor at a
time.
visitorInfoList[ Req. Object Body Information about a visitor. See
Request Example
{
"receptionistId": "1",
"visitEndTime": "2018-07-26T16:00:00+08:00",
{
"VisitorInfo": {
"gender": 1,
"email": "null",
"phoneNo": "13600000000",
"plateNo": "BBBA",
"remark": "null",
"faces": [
{
"faceData": "/9j/4AAQSkZJRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}
303
],
"fingerPrint": [
{
}
],
"cards": [
{
"cardNo": "123456"
}
]
}
}
]
}
Response Parameters

characters.
change each time you edit the visitor
information. The maximum length is
64 characters.
Request Example
{
"code": "0",
"msg": "Success",
"data":
}
304
5.6.5 POST /artemis/api/visitor/v2/appointment

Make a reservation for a visitor.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v2/appointment
Request Parameters

Type
'/\:*?"<>|
which can be obtained via
POST /artemis/api/
resource/v1/person/advance/
personList and consists of up to
64 characters.
appointStartTi Req. String Body Expected time of arrival in ISO
me 8601 format, which is
represented by "yyyy-MM-
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
characters.
appointEndTi Req. String Body Expected time of leaving in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
characters. If the visitor has
assigned to the visitor will be
unassigned.
305

Type
visitReasonTy Req. Number Body Visiting purpose type: 0-
meeting, 4-others.
visitReasonDe Opt. String Body Visiting purpose, this
tail parameters is required when
the value of visitReasonType is
4. The maximum length is 128
characters.
supports adding one visitor at a
time.
accessInfo Opt. Array Body List of the visitor's access
permission, which consists of
accessInfo[0] Opt. AccessLevel Body Visitor's access permission.
Request Example
{
"receptionistId":"2",
"appointStartTime":"2021-05-09T15:00:00+08:00",
"appointEndTime":"2021-05-14T15:00:00+08:00",
"visitReasonType":0,
"visitReasonDetail":"null",
"visitorInfoList":[
{
"VisitorInfo":{
"visitorFamilyName":"mmm",
"visitorGivenName":"yyyy",
"gender":1,
"email":"1@qq.com",
"phoneNo":"13600000000",
"plateNo":"Zhe A",
"companyName":"hik",
"certificateType":111,
"certificateNo":"dddd2234",
"remark":"null",
306
"faces":[
{
"faceData":"/9j/4AAQSkZRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}
],
"identiPhoto":[
{
"identiPhotoData":"/9j/4AAQSkZRgABAQEAAAAAAAD/4QBCRXhpZgAATU.."
}
],
"customField":[
{
"customID":"1",
"customFieldName":"",
"customFieldType":0,
"customFieldValue":""
}
]
}
}
],
"accessInfo": {
"accessLevelList": [
{
"accessLevel": {
"id": 1,
"baseInfo": {
"name": "1"
}
}
}
]
}
}
Response Parameters

characters.
307

characters.
AppointCode Opt. String Reservation code, which consists of
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"visitorId":"2",
"AppointCode":"5080"
}
}
5.6.6 POST /artemis/api/visitor/v1/appointment/single/delete

Delete a visitor's reservation record.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/appointment/single/delete
Request Parameters

Type
308

Type
'/\:*?"<>|
Request Example
{
"appointRecordId ": "5"
}
Response Parameters

characters.
Request Example
{
"code": "0",
"msg": "Success",
"data":""
}
5.6.7 POST /artemis/api/visitor/v2/appointment/update

Edit a visitor's reservation record.
309
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v2/appointment/update
Request Parameters

Type
'/\:*?"<>|
characters.
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
characters.
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
unassigned.
visitReasonTy Req. Number Body Visiting purpose type: 0-
meeting, 4-others.
310

Type
visitReasonDe Opt. String Body Visiting purpose, this
tail parameters is required when
the value of visitReasonType is
characters.
supports editing one visitor's
information at a time.
accessInfo Opt. Array Body List of the visitor's access
permission, which consists of
accessInfo[0] Opt. AccessLevel Body Visitor's access permission.
Request Example
{
"receptionistId":"",
"appointStartTime":"2020-10-26T15:00:00+08:00",
"appointEndTime":"2020-10-29T15:00:00+08:00",
"visitReasonType":0,
"visitReasonDetail":"null",
"visitorInfoList":[{
"VisitorInfo":{
"visitorFamilyName":"null",
"visitorGivenName":"null",
"gender":1,
"email":"",
"phoneNo":"13600000000",
"plateNo":"A",
"companyName":"hik",
"certificateType":111,
"certificateNo":"null",
"remark":"null",
"faces":"null",
"customField":[{
"customID":"1",
"customFieldType":0,
311
"customFieldValue":""
}]
}
}],
"accessInfo":{
"accessLevelList":[{
"accessLevel":{
"id":1,
"baseInfo":{
"name":"1"
}
}
}]
}
}
Response Parameters

characters.
change each time you edit the visitor
information. The maximum length is
64 characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"visitorId": "5",
"appointCode": "6582"
312
}
}
5.6.8 POST /artemis/api/visitor/v1/visitor/out

Check out a visitor and the visitor's access permission will be revoked.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitor/out
Request Parameters

Type
'/\:*?"<>|
appointRecord Req. String Body Reservation record ID.
Id
Request Example
{
"appointRecordId": "1"
}
Response Parameters

characters.
313

Response Example
{
"code": "0",
"msg": "Success",
"data":
}
5.6.9 POST /artemis/api/visitor/v1/appointment/appointmentlist

Get the list of reservation records.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/appointment/appointmentlist
Request Parameters

Type
'/\:*?"<>|
500.
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
314

Type
characters.
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
unassigned.
visitorName Opt. String Body Visitor's name, which consists
companyNam Opt. String Body Name of the company, which
interviewNam Opt. String Body Name of the person to be
e visited, which consists of up to
64 characters.
appointCode Opt. String Body Reservation code, which
identiCode Opt. String Body ID Card number, which consists
phoneNo Opt. String Body Phone number, which consists
appointState Opt. String Body Reservation status: 0
(reservation record has been
added); 1 (reservation has
been invalid); 2 (visitor has
arrived). The maximum length
is 64 characters.
visitorReason Opt. String Body Visiting purpose, which consists
315
Request Example
{
"pageNo": 1,
"pageSize": 100,
"appointStartTime": "2021-04-09T15:00:00+08:00",
"appointEndTime": "2021-05-19T15:00:00+08:00",
"visitorName": "sad",
"interviewName": "",
"appointCode": "",
"identiCode": "111",
"phoneNo": "",
"appointState": "",
"visitorReason": 4
}
Response Parameters

characters.
list Opt. Array Reservation record list.
list[0] Opt. VisitorappointInf Information of a reservation record.
o
316
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 100,
"list": [{
"appointStartTime": "2021-05-06T17:00:39+08:00",
"appointEndTime": "2021-05-06T23:59:59+08:00",
"appointCode": "5905",
"appointID": "5",
"visitReasonType": 4,
"visitorReasonName": "other",
"visitReasonDetail": "123",
"appointStatus": 0,
"visitorInfo": {
"visitorId": "4",
"email": "",
"remark": "",
"visitorFamilyName": "sdasd",
"visitorGivenName": "sad",
"visitorName": "sad sdasd",
"gender": 1,
"plateNo": "",
"phoneNo": "",
"companyName": "hik",
"certificateNo": "1234567",
"visitorPhoto": {
"haveVisitorPhoto": 0,
"haveIdentiPhoto": 0
}
}
}]
}
}
5.6.10 POST /artemis/api/visitor/v1/appointment/downloadpicture

Get the picture of a visitor.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/appointment/downloadpicture
317
Request Parameters

Type
'/\:*?"<>|
visitorId Req. String Body Visitor ID, which consists of up
to 64 characters.
picUrl Req. String Body URL of the visitor's picture used
for reservation, which consists
picType Req. String Body Picture type: 0-small picture, 1-
big picture, 3-ID photo. The
characters.
Request Example
{
"visitorId": "1",
"picType": "0"
}
Response Parameters

characters.
318
Request Example
5.6.11 POST /artemis/api/visitor/v1/visitorconfig/customfields

Search for the custom information about visitors.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitorconfig/customfields
Request Parameters

Type
'/\:*?"<>|
500.
customFieldN Opt. String Body Custom field for fuzzy search.
ame
Request Example
{
"pageIndex":0,
"pageSize":0,
"customFieldName":""
}
319
Response Parameters

characters.
pageIndex Opt. Number Current page, the maximum length is
32 characters.
CustomField Opt. Array List of the custom information about
visitors.
CustomField[0] Opt. CustomField Custom information about a visitor.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"CustomFieldList":{
"TotalNum":0,
"pageIndex":0,
"pageSize":0,
"CustomField":[
{
"indexCode":0,
"PresetValueList":{
"PresetValue":[
{
320
"indexCode":0,
"value":""
}
]
}
}
]
}
}
}
5.6.12 POST /artemis/api/visitor/v1/visitorgroups

Search for the information about visitor groups by group name.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitorgroups
Request Parameters

Type
'/\:*?"<>|
visitorGroupN Opt. String Body Visitor group name, which
ame consists of up to 128
characters.
Request Example
{
"SearchCriteria": {
"visitorGroupName": ""
}
}
Response Parameters

321

characters.
indexCode Req. String Group ID, which consists of up to 32
characters.
name Req. String Group name, which consists of up to
64 characters.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"VisitorGroupList":{
"VisitorGroup":[{
" indexCode":0,
"baseInfo":{
"name":""
}
}]
}
}
}
5.6.13 POST /artemis/api/visitor/v1/visitorgroups/groupinfo

Search for visitors' information by visitor group ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitorgroups/groupinfo
322
Request Parameters

Type
'/\:*?"<>|
indexCode Req. String Body Visitor group ID, which consists
identifiyCode Opt. string Body ID No., which consists of up to
128 characters.
personName Opt. string Body Name of the visitor, which
characters.
phoneNum Opt. string Body Phone number, which consists
companyNam Opt. string Body Company name, which consists
temperatureSt Opt. Number Body Temperature status: 0
atus (exception), 1 (normal), 2
(unknown), -1 (all).
blackLisitStatu Opt. Number Body Whether the visitor is in the
s blocklist: 0 (no), 1(yes), -1 (all).
Request Example
{
"VisitorListRequest":{
"indexCode":"1",
"pageIndex":0,
"pageSize":0,
"searchCriteria":{
"identifiyCode":"",
"personName":"",
"phoneNum":"",
"companyName":"",
"remperatureStatus":0,
"blackLisitStatus":0
}
323
}
}
Response Parameters

characters.
pageIndex Opt. Number The current page No, the maximum
list Opt. Array List of information about visitors'
reservation.
list[0] Opt. Visitor A visitor's reservation information.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"pageSize":1,
"pageIndex ":10,
"total":10,
"VisitorList":{
"Visitor":[{
"ID":0,
"BaseInfo":{
"fullName":""
}
324
}]
}
}
}
5.6.14 POST /artemis/api/visitor/v1/visitor/visitorInfo

Search for visitors' information by condition.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitor/visitorInfo
Request Parameters

Type
500.
searchCriteria Opt. Object Body Search conditions.
visitorGroupID Opt. String Body Visitor group ID, which consists
identifiyCode Opt. String Body ID No., which consists of up to
64 characters.
personName Opt. String Body Name of the visitor, which
characters.
phoneNum Opt. String Body Phone number, which consists
companyNam Opt. String Body Company name, which consists
identificationT Opt. String Body Identification type, which
ype consists of up to 128
characters.
325
Request Example
{
"pageNo ":"0",
" pageSize":"20",
"searchCriteria":{
"visitorGroupID":"1,2,3"
}
}
Response Parameters

characters.
data Opt. VisitorInfo Response data details.
5.6.15 POST /artemis/api/visitor/v1/visitor/single/visitorinfo

Get the visitor's information by visitor ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/visitor/single/visitorinfo
Request Parameters

Type
visitorId Req. String Body Visitor ID, which consists of up
to 64 characters.
326
Request Example
{
"visitorId": "125"
}
Response Parameters

characters.
data Opt. VisitorInfo Response data details.
5.6.16 POST /artemis/api/visitor/v1/auth/reapplication

Apply persons' access level settings or information (person ID, person name, face picture,
fingerprint, card No., validity, etc.) to device when the persons' access level or person information
changed.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/auth/reapplication
Request Parameters

Type
'/\:*?"<>|
327
Response Parameters

characters.
to 256 characters.
data Opt. String Response data.
Response Example
{
"code": "0",
"msg": "ok",
"data": ""
}
5.7 Vehicle and Parking API

Here provides APIs for vehicle management and vehicle parking management.
5.7.1 POST /artemis/api/pms/v1/image_data

Get vehicle pictures from the searched vehicle passing records by picture URL.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/pms/v1/image_data
328
Request Parameters

Type
'/\:*?"<>|
domainId Opt. String Header Domain ID, which is used in the
streaming URL and consists of
up to 16 characters. If this field
is not configured, the value will
be determined by the request.
picUri Req. String Body Picture URL, which consists of
Request Example
{
domainId : 0
{
"aswSyscode": "hnj5h245h5234h45345y",
"picUri": "/pic?=d7ei703i10cd*73a-d5108a--22cd0c9d6592aiid="
}
Response Parameters

characters.
data Opt. String Binary picture data in the response.
329
Response Example
HTTP/1.1
Content-Type:image/jpeg;charset=utf-8
Date:YourDate
Content-Length:image_length
[Picture Data]
5.7.2 POST /artemis/api/pms/v1/crossRecords/page

Set search conditions (e.g., camera ID, license plate number, vehicle owner name, etc.) to search
for vehicle passing records, and the search results will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/pms/v1/crossRecords/page
Request Parameters

Type
'/\:*?"<>|
plateNo Opt. String Body License plate number, which
ownerName Opt. String Body Vehicle owner name, which
contact Opt. String Body Contact number of vehicle
owner, which consists of up to
32 characters.
yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00. And the
330

Type
characters.
yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00. And the
characters.
500.
Note
The days between start time and end time should be no more than 31 days.
Request Example
{
"plateNo": "a123456",
"ownerName": "aaa",
"contact": "123",
"startTime": "2018-07-26T15:00:00+08:00",
"endTime": "2018-07-26T16:00:00+08:00",
"pageNo": 1,
"pageSize": 10"
}
Response Parameters

331

characters.
list Opt. Array Vehicle passing record list.
list[0] Opt. Object Information of a vehicle passing
record in the list. See details in
PassVehicleRecord .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total":1,
"pageNo":1,
"pageSize":15,
"list": [
{
"crossRecordSyscode": "74554754035654645",
"plateNo": "a123456",
"ownerName": "aaa",
"contact": 123,
"vehicleType": 1,
"vehiclePicUri": "/pic?=d7ei703i10cd*73a-d5108a--22cd0c9d6592aiid=",
"crossTime": "2018-07-26T15:00:00+08:00",
"createTime": "2018-07-26T15:00:00+08:00"
}
]
}
}
332
5.7.3 POST /artemis/api/vehicle/v1/parkinglot/list

Get the parking lot list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/parkinglot/list
Request Parameters

Type
'/\:*?"<>|
Response Parameters

characters.
total Req. Number The number of parking lots, the
list Req. Array List of parking lots.
list[0] Req. ParkingLotInfo Parking lot information.
Response Example
{
"code": "0",
333
"msg": "Success",
"data": {
"total": 3,
"list": [
{
"parkingLotIndexCode": "1",
"parkingLotName": "parkinglot",
"parentParkingLotIndexCode": "-1",
"totalSpaceNum": 1000,
"freeSpaceNum": 0,
"totalPermanentSpaceNum": 500,
"freePermanentSpaceNum": 202,
"maxParkingTime": 9
},
{
"parkingLotName": "parking lot 2",
"parentParkingLotIndexCode": "-1",
"totalSpaceNum": 600,
"freeSpaceNum": 600,
"totalPermanentSpaceNum": 500,
"freePermanentSpaceNum": 500,
"maxParkingTime": 7
},
{
"parkingLotName": "parking lot 3",
"parentParkingLotIndexCode": "2",
"totalSpaceNum": 2,
"freeSpaceNum": 2,
"totalPermanentSpaceNum": -1,
"freePermanentSpaceNum": -1,
"maxParkingTime": -1
}
]
}
}
5.7.4 POST /artemis/api/vehicle/v1/floor/list

Get the floor list of the specified parking lot.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/floor/list
334
Request Parameters

Type
'/\:*?"<>|
parkingLotInd Opt. String Body Parking lot ID, the maximum
exCode length is 1024 characters.
Information about all parking
lots will be returned if no ID is
specified.
Request Example
{
"parkingLotIndexCode": "1"
}
Response Parameters

characters.
total Req. Number The number of floors, the maximum
list Req. Array Floor information list.
list[0] Req. FloorInfo Floor information.
335
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":3,
"list":[{
"floorIndexCode":"12",
"floorName":"666",
"parkingLotIndexCode":"1",
"parkingLotName":" xxxx"
},
{
"floorName":"111",
"parkingLotName":"xxxx"
},
{
"floorName":"122",
"parkingLotName":"xxxx"
}]
}
}
5.7.5 POST /artemis/api/vehicle/v1/floor/overview

Get the occupancy of one or multiple floors of the parking lot, including the total number of
parking spaces and the number of vacant parking spaces.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/floor/overview
Request Parameters

Type
336

Type
'/\:*?"<>|
Information of all parking lots
will be returned if no parking
lot ID is specified.
floorIndexCod Opt. String Body Floor ID, the maximum length
e is 1024 characters. Information
of all floors will be returned if
no floor ID is specified.
Request Example
{
"parkingLotIndexCode" : "1",
"floorIndexCode" : "14"
}
Response Parameters

characters.
totalSpaceNum Req. Number Total number of parking spaces, the
freeSpaceNum Req. Number Number of vacant parking spaces, the
337

total Req. Number Total number of floors, the maximum
list Req. Array List of floor overview.
list[0] Req. FloorOverViewInf Floor overview.
o
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":1,
"totalSpaceNum":50,
"freeSpaceNum":48,
"list":[{
"floorName":"122",
"parkingLotIndexCode":1,
"totalSpaceNum":50,
"freeSpaceNum":48,
"spaceTypeOverView":[{
"typeIndexCode":"1",
"typeName":"general",
"typeColor":"#FFFF00",
"totalSpaceNum":6,
"freeSpaceNum":4
},
{
"typeName":"allow",
"typeColor":"#00FF00",
"totalSpaceNum":6,
"freeSpaceNum":6
},
{
"typeName":"forbid",
"typeColor":"#0000FF",
"totalSpaceNum":8,
"freeSpaceNum":8
}]
}]
}
}
338
5.7.6 POST /artemis/api/vehicle/v1/floor/parkingspace/status

Get the real-time status of all parking spaces on the specified floor.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/floor/parkingspace/status
Request Parameters

Type
'/\:*?"<>|
floorIndexCod Req. String Body Floor ID, the maximum length
e is 1024 characters.
Request Example
{
"floorIndexCode": "1"
}
Response Parameters

characters.
total Req. Number Total number of parking spaces, the
339

list Req. Array List of parking spaces.
list[0] Req. ParkingSpaceInfo Information of a parking space.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":3,
"list":[{
"spaceIndexCode":"1",
"spaceType":3,
"serial":"1",
"status":1,
"plateNumber":"",
"creatTime":"2021-07-26T19:58:12+08:00",
"duration":16,
"parkingImageUrl":"Vsm://PHQG#20210726#20210726_193035917.d:104558170:490700",
"platenumberImageUrl":""
},
{
"spaceType":3,
"serial":"2",
"status":1,
"plateNumber":"",
"creatTime":"2021-07-26T11:23:36+08:00",
"duration":30892,
},
{
"spaceType":3,
"serial":"3",
"status":1,
"plateNumber":"",
"creatTime":"2021-07-26T13:41:15+08:00",
"duration":22633,
}]
340
}
}
5.7.7 POST /artemis/api/vehicle/v1/parkinglot/passageway/record

Get the vehicle passing records of the specified parking lot.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/parkinglot/passageway/record
Request Parameters

Type
'/\:*?"<>|
pageIndex Req. Number Body The current page No., which is
characters.
characters.
queryInfo Req. Object Body Search condition.
parkingLotInd Req. String Body Parking lot ID, the maximum
beginTime Req. String Body Start time in ISO 8601 format
"2018-07-26T15:00:00+08:00".
bytes.
341

Type
"2018-07-26T15:00:00+08:00".
bytes.
ownerName Opt. String Body Vehicle owner name, the
characters.
plateLicense Opt. String Body License plate number, the
characters.
directionType Opt. Number Body Direction: -1 (all), 1 (entry), 2
(exit).
allowResult Opt. Number Body Whether the passing is
allowed: -1 (all), 1 (allowed), 2
(not allowed).
Request Example
{
"pageIndex": 1,
"pageSize": 3,
"queryInfo": {
"beginTime": "2021-07-21T00:00:00+08:00",
"endTime": "2021-07-21T23:59:59+08:00",
"ownerName": "",
"plateLicense": "",
"directionType": -1,
"allowResult": -1
}
}
Response Parameters

342

characters.
total Req. Number Total number of records, the
pageIndex Req. Number The current page No., the maximum
pageSize Req. Number Number of records on each page, the
list Req. Array List of vehicle passing records.
list[0] Req. PassingRecordInf Information about a vehicle passing
o record.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":3,
"pageIndex":1,
"pageSize":3,
"list":[{
"guid":"0F388D71AFA346CABCBA4FB91312861B",
"parkingLotInfo":{
"parkingLotName":"parking lot33"
},
"passagewayInfo":{
"passagewayIndexCode":"1",
"passagewayName":"Default Entrance & Exit01"
},
"laneInfo":{
"laneIndexCode":"1",
"laneName":"entrance 1",
"direction":1
},
343
"personInfo":{
"cardNum":"",
"ownerName":"",
"ownerPhoneNum":""
},
"carInfo":{
"plateLicense":"BJ08FNV",
"carType":3,
"ImageUrl":"Vsm://PHQG#20210721#20210721_232955105.d:198227798:102096",
"EnterTime":"2021-07-21T23:59:57+08:00",
"ExitTime":""
},
"allowType":3,
"allowResult":2
},
{
"guid":"31775DB5BF1940F681D03FD7DBDA623E",
"parkingLotInfo":{
},
"passagewayInfo":{
},
"laneInfo":{
"direction":1
},
"personInfo":{
"cardNum":"",
"ownerName":"",
"ownerPhoneNum":""
},
"carInfo":{
"plateLicense":"N500GES",
"carType":3,
"EnterTime":"2021-07-21T23:59:50+08:00",
"ExitTime":""
},
"allowType":3,
"allowResult":2
},
{
"guid":"4EE0D343B9D94DA58FA335D2506DC290",
"parkingLotInfo":{
},
"passagewayInfo":{
344
},
"laneInfo":{
"direction":1
},
"personInfo":{
"cardNum":"",
"ownerName":"",
"ownerPhoneNum":""
},
"carInfo":{
"plateLicense":"VE54CTY",
"carType":3,
"EnterTime":"2021-07-21T23:59:44+08:00",
"ExitTime":""
},
"allowType":3,
"allowResult":2
}]
}
}
5.7.8 POST /artemis/api/vehicle/v1/parkingspace/record

Get the vehicle parking records.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/parkingspace/record
Request Parameters

Type
'/\:*?"<>|
characters.
345

Type
characters.
queryInfo Req. Object Body Search condition.
floorIndexCod Opt. String Body Floor ID, the maximum length
e is 1024 characters.
beginTime Req. String Body Start time in ISO 8601 format
"2018-07-26T15:00:00+08:00".
bytes.
"2018-07-26T15:00:00+08:00".
bytes.
spaceSerial Opt. String Body Space serial No., the maximum
characters.
statusType Opt. Number Body Parking status: 0 (parking), 1
(exited), -1 (all).
Request Example
{
"pageIndex":1,
"pageSize":3,
"queryInfo":{
346
"beginTime":"2021-07-22T00:00:00+08:00",
"endTime":"2021-07-22T23:59:59+08:00",
"spaceSerial":"1",
"plateLicense":"",
"statusType":0
}
}
Response Parameters

characters.
total Req. Number Total number of records, the
pageIndex Req. Number The current page No., the maximum
pageSize Req. Number Number of records on each page, the
list Req. Array List of vehicle parking records.
list[0] Req. ParkingRecordInf Information about a vehicle parking
o record.
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"total":3,
"pageIndex":1,
347
"pageSize":3,
"list":[{
"guid":30726,
"parkingLotName":"parkinglot",
"floorName":"F3",
"parkingSpaceSerial":"11",
"plateLicense":"ARB209KE",
"parkingStatusType":0,
"occurTime":"2021-07-22T23:59:51+08:00"
},
{
"guid":30725,
"floorName":"F3",
"plateLicense":"unknown",
"occurTime":"2021-07-22T23:59:41+08:00"
},
{
"guid":30721,
"floorName":"F3",
"plateLicense":"unknown",
"occurTime":"2021-07-22T23:59:18+08:00"
}]
}
}
5.7.9 POST /artemis/api/vehicle/v1/parkingfee/calculate

Calculate the parking fee based on parking information (parking start time, total parking time,
parking fee rule type, parking fee rule ID, parking fee rule name) for a specific license plate No.
from exact match.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/parkingfee/calculate
348
Request Parameters

Type
'/\:*?"<>|
characters.
Request Example
{
"plateLicense" : "2700H"
}
Response Parameters

details.
data Req. Object See details in ParkingFeeCalculate .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"plateLicense": "2700H",
"parkingInTime": "2022-03-30T11:39:35+08:00",
"parkingDuration": 1134404,
"feeRuleType": 1,
"feeRuleIndexCode": "1",
"feeRuleName": "rule1",
"fee": "10.00"
349
}
}
5.7.10 POST /artemis/api/vehicle/v1/parkingfee/confirm

Confirm the payment of parking fee and allow exit for a specific license plate No. from exact match.
Payment on exit will be made via booth, and the vehicle is allowed to pass the barrier gate once it
is recognized by camera; payment before exit will be made via toll center, and if the final parking
time exceeded the paid duration, the extra fee will also be charged on exit via booth.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/vehicle/v1/parkingfee/confirm
Request Parameters

Type
'/\:*?"<>|
plateLicense Req. String Body License plate number, the
characters.
immediatelyLe Req. Number Body Whether the vehicle is leaving
ave the parking lot immediately.
fee Req. String Body Parking fee. The maximum
length is 32.
Request Example
{
"plateLicense" : "2700H",
"immediatelyLeave" : 0,
"fee" : "200"
}
350
Response Parameters

details.
data Req. Object See details in ParkingFeeConfirm .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"fee": "200.00",
"feeTime": "2022-04-12T14:48:11+08:00"
}
}
5.7.11 POST /artemis/api/vehicle/v1/vehicle/blocklist/add

Add a vehicle to the blocklist.
Request URL
https://[serverAddress]:[serverPort]/api/vehicle/v1/vehicle/blocklist/add
Request Parameters

Type
' / \ : * ? " < > |.
plateLicense Req. String Body License plate number, which
351

Type
characters like ' / \ : * ? " < > |.
characters like ' / \ : * ? " < > |.
phoneNo Opt. String Body Contact number, which can
contain numbers from 0-9, and
special characters ＋ and －.
description Opt. String Body Vehicle description, which
effectiveDate Req. String Body Start time of blocking, in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String Body End time of blobking, in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
Request Example
{
"plateLicense":"123",
"personGivenName":"KaiRui",
"personFamilyName":"Jin",
"phoneNo":"1-1807894561",
352
"description":"xxxxxx",
"effectiveDate":"2022-03-21T00:00:00+08:00",
"expiredDate":"2023-03-25T23:59:59+08:00"
}
Response Parameters

details.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.7.12 POST /artemis/api/vehicle/v1/vehicle/blocklist/get

Search the vehicle blocklist. Advanced search can be performed by specifying the license plate
number, family name of the owner, given name of the owner, contact number of the owner, or
vehicle description as the keyword. Fuzzy search is supported. If no search condition specified,
information of all vehicles will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/api/vehicle/v1/vehicle/blocklist/get
Request Parameters

Type
353

Type
' / \ : * ? " < > |.
characters.
characters.
keyWords Opt. String Body The license plate number,
family name of the owner,
given name of the owner,
contact number of the owner,
or vehicle description. Fuzzy
search is supported. If no
search condition specified,
information of all vehicles will
Request Example
{
"pageIndex": 1,
"pageSize" : 10,
"keyWords" : ""
}
Response Parameters

354

details.
data Req. Object See details in PageInfo.

pageNo Opt. Number The current page No., which is
pageSize Opt. Number Number of records on each page,
which is between 1 and 500.
list Opt. object See details in ForbiddenVehicleInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageIndex": 1,
"pageSize": 10,
"list": [
{
"vehicleIndexCode": "1",
"plateLicense": "123",
"personGivenName": "KaiRui",
"personFamilyName": "Jin",
"phoneNo": "1-1807894561",
"description": "xxxxxx",
"effectiveDate": "2022-03-21T00:00:00+08:00",
"expiredDate": "2023-03-25T23:59:59+08:00"
}
]
}
}
5.7.13 POST /artemis/api/vehicle/v1/vehicle/blocklist/modify

Edit the vehicle in the blocklist.
355
Request URL
https://[serverAddress]:[serverPort]/api/vehicle/v1/vehicle/blocklist/modify
Request Parameters

Type
'/\:*?"<>|
vehicleIndexC Req. String Body Blocklist vehicle ID, which
plateLicense Req. String Body License plate number, which
characters like ' / \ : * ? " < > |.
characters like ' / \ : * ? " < > |.
phoneNo Opt. String Body Contact number, which can
contain numbers from 0-9, and
special characters ＋ and －.
description Opt. String Body Vehicle description, which
effectiveDate Req. String Body Start time of blocking, in ISO
356

Type
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String Body End time of blobking, in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00".
Request Example
{
"vehicleIndexCode" : "1",
"plateLicense":"9999",
"personGivenName":"KaiRui",
"personFamilyName":"Jin",
"phoneNo":"1-1807894561",
"description":"xxxxxx",
"effectiveDate":"2022-03-21T00:00:00+08:00",
"expiredDate":"2023-03-25T23:59:59+08:00"
}
Response Parameters

details.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
357
5.7.14 POST /artemis/api/vehicle/v1/vehicle/blocklist/delete

Delete the vehicle from the blocklist.
Request URL
https://[serverAddress]:[serverPort]/api/vehicle/v1/vehicle/blocklist/delete
Request Parameters

Type
'/\:*?"<>|
vehicleIndexC Req. String Body ID list of vehicles from blocklist,
odes in "1,2,3,4,5" format, which
Request Example
{
"vehicleIndexCodes" : "1,2,3"
}
Response Parameters

details.
Response Example
{
"code": "0",
"msg": "Success",
358
"data": ""
}
5.8 Access Control API

Here provides APIs for access point control, access record search, applying person information,
getting access control event picture, and so on.
5.8.1 POST /artemis/api/acs/v1/auth/applicationResult

Get status details of applying person information or persons' access level settings to device.
Currently, the returned status details are about applying failure and waiting to be applied.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/auth/applicationResult
Request Parameters

Type
' / \ : * ? " < > |.
applicationRes Req. Number Body Applying result type: 1-get
ultType statistics data, 2-get error
information.
pageNo Opt. Number Body The current page No., which is
bytes. This parameter is valid
only when the value of
applicationResultType is 2.
pageSize Opt. Number Body Number of records on each
bytes. This parameter is valid
359

Type
only when the value of
type Req. Number Body Access level type: 0 (access
control), 1 (visitor)
Request Example
{
"applicationResultType": 1,
"pageNo": 1,
"pageSize": 2,
"type": 1
}
Response Parameters

characters.
data Opt. Object Applying result details.
statisticResult Opt. Object Statistics results, see details in
StatisticResult . This parameter will
be returned when the value of
applicationErrorR Opt. Object Applying failure information, see
esult details in ApplicationErrorResult .
This parameter will be returned when
the value of applicationResultType is
2.
360
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"statisticResult": {
"unApplicationCount": 3,
"applicationFailCount": 2,
"editAndUnApplicationCount": 1
}
}
}
5.8.2 POST /artemis/api/acs/v1/door/doControl

Control the door to open, close, remain open, and remain closed by door ID.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/door/doControl
Request Parameters

Type
'/\:*?"<>|
doorIndexCod Req. List of String Body Access point ID, and up to 10
es access points can be obtained.
controlType Req. Number Body Control types: 0-remain open,
1-close, 2-open, 3-remain
open.
Request Example
{
"doorIndexCodes":["1","2"],
"controlType":3
}
361
Response Parameters

characters.
to 256 characters.
data Opt. Array Information list of access point
control results.
data[0] Opt. Object Information of an access point control
result. Refer to DoorControlResult for
details.
Response Example
{
"code":"0",
"msg":"Success",
"data":[
[
{
"doorIndexCode":"1",
"controlResultCode":0,
"controlResultDesc":"Success"
},
{
"doorIndexCode":"2",
"controlResultCode":0,
"controlResultDesc":" Success "
}
]
]
}
362
5.8.3 POST /artemis/api/acs/v1/door/events

Set search conditions (time, person name, access point ID, event type, etc.) to search for access
records (access by card, face, fingerprint, and so on), and the search results (authentication
method, card information, face information, fingerprint information, etc.) will be returned by page.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/door/events
Request Parameters

Type
'/\:*?"<>|
eventType Req. Number Body Event type code, which is a
details.
personName Opt. String Body Person name, which which
consists of up to 32 characters,
doorIndexCod Req. String Body Access point ID, and up to 10
es access points can be obtained.
yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00. And the
characters.
yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00. And the
363

Type
characters.
500.
temperatureSt Opt. Number Body Temperature status: 0-
atus unknown, 1-normal, 2-
abnormal.
wearMaskStat Opt. Number Body Wearing mask or not: 0-
us unknown, 1-yes, 2-no.
Note
● The days between start time and end time should be no more than 31 days.
● At least one of the parameters eventType and personName must be configured.
Request Example
{
"startTime":"2018-08-10T12:00:00.000+08:00",
"endTime":"2018-08-11 12:00:00.000+08:00",
"eventType": 197151,
"personName": "a",
"doorIndexCodes":["1","2"],
"pageNo":1,
"pageSize":100
}
Response Parameters

364

characters.
list Opt. Array Card swiping or access record list.
list[0] Opt. Object Information of a card swiping record
in the list. See details in
PersonInOutEvents .
Response Example
{
"code":"0",
"msg":"Success",
"data":{
"pageSize":100,
"pageNo":1,
"total":1,
"list":[
{
"eventId":"58689546546576576215475",
"eventType":"197151",
"eventTime":"2018-08-10 20:00:00",
"personId":"1",
"personName":"a",
"doorName":"xxxDoor",
"doorIndexCode":"1"
}
]
}
}
365
5.8.4 POST /artemis/api/acs/v1/event/pictures

Get pictures of access control events.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/event/pictures
Request Parameters

Type
domainId Opt. Number Header Domain name of pictures to be
obtained.
picUri Req. String Body Picture URI (relative path). The
Request Example
{
"picUri":"0B4E92A30AF914C1285613A4FBD9F761F"
}
Response Example
5.8.5 POST /artemis/api/acs/v1/privilege/group

Get access level list.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/privilege/group
366
Request Parameters

Type
'/\:*?"<>|
500.
type Req. Number Body Access level type value: 1
(access control), 2 (visitor).
Request Example
{
"pageNo": 1,
"pageSize": 10,
"type": 1
}
Response Parameters

characters.
367

list Opt. Array Information list of access levels.
list[0] Opt. Object Information about an access level.
See details in PrivilegeGroupInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 2,
"pageNo": 1,
"pageSize": 10,
"list": [
{
"privilegeGroupId": "2",
"privilegeGroupName": "234",
"description": "",
"timeSchedule": {
"indexCode": "1",
"name": ""
}
},
{
"privilegeGroupName": "123",
"description": "",
"timeSchedule": {
"indexCode": "1",
"name": ""
}
}
]
}
}
5.8.6 POST /artemis/api/acs/v1/privilege/group/single/addPersons

Assign access levels to persons.
368
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/privilege/group/single/addPersons
Request Parameters

Type
'/\:*?"<>|
privilegeGrou Req. String Body Access group ID, which consists
pId of up to 64 characters.
control), 2 (visitor).
list Req. Array Body Person information list.
list[0] Req. Object Body Information about a person.
id Req. String Body Person (visitor) ID, which
Request Example
{
"type": 1,
"list": [
{
"id": "1"
}
]
}
Response Parameters

369

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
5.8.7 POST /artemis/api/acs/v1/privilege/group/single/deletePersons

Unassign access levels to persons.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/privilege/group/single/deletePersons
Request Parameters

Type
'/\:*?"<>|
privilegeGrou Req. String Body Access group ID, which consists
pId of up to 64 characters.
control), 2 (visitor).
list Req. Array Body Person information list.
370

Type
list[0] Req. Object Body Information about a person in
the list.
id Req. String Body Person (visitor) ID, which
Request Example
{
"type": 1,
"list": [
{
"id": "1"
}
]
}
Response Parameters

characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": ""
}
371
5.8.8 POST /artemis/api/acs/v1/privilege/group/single/personList

Get information list of persons related to the access levels.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/acs/v1/privilege/group/single/personList
Request Parameters

Type
'/\:*?"<>|
500.
type Req. Number Body Access level type value: 1-
access control, 2 (visitor,
currently, it is not supported).
privilegeGrou Req. String Body Access group ID, the maximum
pId length is 64 characters.
Request Example
{
"pageNo": 1,
"pageSize": 2,
"type": 1,
"privilegeGroupId": "1"
}
Response Parameters

372

characters.
list[0] Opt. Object Information about a person. See
id Req. String Person ID, which consists of up to 64
characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageNo": 1,
"pageSize": 2,
"list": [
{
"id": "1"
}
]
}
}
373
5.8.9 POST /artemis/api/visitor/v1/auth/reapplication

Apply persons' access level settings or information (person ID, person name, face picture,
fingerprint, card No., validity, etc.) to device when the persons' access level or person information
changed.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/auth/reapplication
Request Parameters

Type
'/\:*?"<>|
Response Parameters

characters.
to 256 characters.
data Opt. String Response data.
Response Example
{
"code": "0",
"msg": "ok",
"data": ""
}
374
5.8.10 POST /artemis/api/visitor/v1/person/ID/elementDownloadDetail

Get the access level application information of a visitor.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/visitor/v1/person/ID/elementDownloadDetail
Request Parameters

Type
id Req. String Body Visitor ID. The maximum length
is 64.
Request Example
{
"visitorId": "125"
}
Response Parameters

characters.
data Opt. elementDownloa List of access level application
dDetail [] information. See details in
ElementDetail . The maximum length
of this field is 128.
Response Example
{
"code": "0",
375
"msg": "Success",
"data": {
"ElementDetailList": {
"ElementDetail": [
{
"BaseInfo": {
"Name": "undefined",
"ElementType": 0,
"Network": 0
},
"ElementStatus": {
"Status": "-1",
"ErrorModule": "0",
"ErrorCode": "0"
},
"CertificateStatusList": {
"CertificateStatus": [
{
"Type": "0",
"ID": "0",
"Status": "-1",
"ErrorModule": "0",
"ErrorCode": "0"
}
]
},
"ID": "0"
}
]
}
}
}
5.9 On-Board Monitoring API
5.9.1 POST /artemis/api/mobilesurveillance/v1/gpsdetails

Get GPS statistics information of on-board devices.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/mobilesurveillance/v1/gpsdetails
376
Request Parameters

Type
'/\:*?"<>|
500.
mobilevehicleI Req. String Body IDs of vehicles linked to on-
ndexCodes board devices. Use comma to
separate multiple items, e.g.,
"1, 2, 5".
startTime Req. String Body Start time of search, in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
characters.
"2018-07- 26T15:00:00
is 64 characters. It should not
exceed 31 days from start to
end.
Request Example
{
"pageNo": 1,
"pageSize": 15
"mobilevehicleIndexCodes":"1,2"
377
"startTime": "2022-02-10T15:00:00+08:00",
"endTime": "2022-02-11T16:00:00+08:00"
}
Response Parameters

characters.
data Req. PageInfo[] Response data details.

list Opt. detailInfo[] Detailed information list.
detailInfo Object Description

mobilevehicleInd Req. String ID of vehicle linked to the on-board
exCode device.
plateNo Number License plate No.
regionIndexCode Number Area ID.
list Req. gpsInfo GPS information.
378
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"total": 1,
"pageIndex": 1,
"pageSize": 10,
"list": [
{
"gps_info_list": [
{
"occurTime": "2022-02-16 11:20:08",
"longitude": -1,
"latitude": -1,
"direction": 0,
"gpsDisplay": "E120,13,42;N30,12,1",
"directionDisplay": "North",
"speed": 10
}
]
}
]
}
}
5.9.2 POST /artemis/api/mobilesurveillance/v1/recordOverview

Search for event records of vehicles linked to on-board devices (only including the brief
information). See details via specific event protocols.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/mobilesurveillance/v1/recordOverview
Request Parameters

Type
379

Type
'/\:*?"<>|
mobilevehicleI Req. String Body IDs of vehicles linked to on-
ndexCodes board devices. Use comma to
separate different items. The
characters.
eventTypes Opt. String Body Event types. Use comma to
separate different items. The
characters.
beginTime Req. String Body Start time of search, in ISO
zone", e.g., "2018-07-
26T15:00:00 + 08:00". The
characters.
"2018-07- 26T15:00:00
is 64 characters. It should not
exceed 31 days from start to
end.
centerLongitu Opt. String Body Center longitude (0 by default).
de The maximum length is 16
characters.
centerLatitude Opt. String Body Center Latitude (0 by default).
characters.
radius Opt. Number Body Radius (unit: m; 0 by default).
380

Type
pageIndex Req. Number Body The target page No., which is
500.
Request Example
{
"pageIndex": 1,
"pageSize": 10,
"mobilevehicleIndexCodes": "1,2",
"eventTypes": "330203,330003",
"beginTime": "2022-02-14T15:00:00+08:00",
"endTime": "2022-02-15T15:00:00+08:00",
"centerLongitude": "0.0",
"centerLatitude": "0.0",
"radius": 0
}
Response Parameters

characters.
data Opt. PageInfo Response data: event records in page.
381

list Opt. RecordOverview Event record list.
Response Example
{
"code": "0",
"msg": "success",
"data": {
"total": "1",
"pageNo": "1",
"pageSize": "10",
"list": [
{
"eventIndexCode": "BF1A2B849C5E4EDC858EF295A4E7DD2D",
"eventType": "330406",
"ownerName": "ll",
"regionName": "area1",
"occurTime": "2022-02-12T15:46:58+08:00",
"longitude": "0.0",
"latitude": "0.0",
"direction": "0",
"speed": 0,
"displayInfo": "E0,0,0;N0,0,0",
"directionInfo": "North"
}
]
}
}
5.9.3 POST /artemis/api/mobilesurveillance/v1/single/record

Search for event information of a on-board device.
382
Request URL
https://[serverAddress]:[serverPort]/artemis/api/mobilesurveillance/v1/single/record
Request Parameters

Type
'/\:*?"<>|
mobilevehicleI Req. String Header ID of vehicle linked to the on-
ndexCode board device. The maximum
eventIndexCo Req. String Header Event record ID. The maximum
de length is 64 characters.
Request Example
{
“mobilevehicleIndexCode":"1",
" eventIndexCode ": "BF1A2B849C5E4EDC858EF295A4E7DD2D"
}
Response Parameters

characters.
data Opt. MSEventRecord Response data: record of an event.
383
MSEventRecord Object Description

eventType Req. Number Event type. The maximum length is 16
characters.
exCode device. The maximum length is 64
characters.
plateNo Req. String License plate No. The maximum
regionName Req. Number Area name. The maximum length is 4
characters.
ownerName Opt. String Vehicle owner name.
phoneNo Opt. String Contact number of the vehicle owner.
The maximum length is 64 characters.
occurTime Req. String GPS report time, in ISO 8601 standard
time format: yyyy-MMdd'T'HH:
26T15:00:00 + 08:00. And the time
longitude Req. String Longitude (integer; including negative
values), actual degrees × 3600 × 100
＋ acutal minutes × 60 × 100 ＋
actual seconds × 100. The maximum
latitude Req. String Latitude (integer; including negative
direction Req. Number Vehicle direction (calculated clockwise
from due north (0); the actual degree
* 100; [0, 36000)).
speed Req. Float Speed (consistent with the HCP
platform: km/h by default). The
384

speedLimit Req. Number Speed threshold (consistent with the
HCP platform: km/h by default). The
displayInfo Req. String Displayed GPS information, e.g., E120,
50, 20; N30, 50, 20. The maximum
directionInfo Req. String Displayed direction ("North",
"Northeast", "East", "Southeast",
"South", "Southwest", "West",
"Northwest"). The maximum length is
16 characters.
image_url_list Opt. image_info_list[] Picture URL list.
image_url Opt. String Picture URL. The maximum length is
256 characters.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"eventType": 330203,
"regionName": "车车",
"ownerName": "",
"phoneNo": "",
"occurTime": "2022-02-16T14:39:36-08:00",
"longitude": "120.204",
"latitude": "30.1894",
"direction": 5628,
"speed": 30,
"speedLimit": "80",
"displayInfo": "E120,12,13;N30,11,21",
"directionInfo": "Northeast",
"image_url_list": [
{
"image_url": "Vsm://PHQG#20220216#20220216_134335874.d:12:62692"
}
]
}
}
385
5.10 Person Search API
5.10.1 POST /artemis/api/body/v1/application/pictureRecognition

Detect the human body in the picture encoded by Base64 and get the coordinates of the body in
the picture, which is the first part of search for matched human bodies on Intelligent Fusion Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/body/v1/application/pictureRecognition
Request Parameters

Type
'/\:*?"<>|
intelligentServ Req. String Body ID for Intelligent Fusion Server
erIndexCode on the HikCentral Professional
platform. The maximum length
is 32.
pictureData Req. String Body Picture data encoded by
Base64.
Request Example
{
"pictureData": "test"
}
Response Parameters

386

characters.

Rect Opt. bodyRecord[] List of detected human body
information. See details in bodyRect .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"Rect": [
{
"height": "0.81",
"width": "0.15",
"x": "0.12",
"y": "0.21"
}
]
}
}
5.10.2 POST /artemis/api/body/v1/application/pictureModel

Model human body in the picture encoded by Base64 and get the modeling data, which is the
second part of search for matched human bodies on Intelligent Fusion Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/body/v1/application/pictureModel
387
Request Parameters

Type
'/\:*?"<>|
is 32.
Base64.
data Req. Object Body Detected human body
information.

bodyRect Req. Object Normalized x-coordinate from the
upper-left corner to the right and y-
coordinate from the upper-left corner
to the downward. Range of value:
[0.000, 1.000].
height Req. String Height of detected human body in the
picture, normalized to [0.000, 1.000].
width Req. String Width of detected human body in the
x Req. String Normalized x-coordinate from the
upper-left corner to the right. Range
of value: [0.000, 1.000].
y Req. String Normalized y-coordinate from the
upper-left corner to the downward.
Range of value: [0.000, 1.000].
388
Request Example
{
"pictureData": "test",
"data": {
"Rect": {
"height": "0.81",
"width": "0.15",
"x": "0.21",
"y": "0.12"
}
}
}
Response Parameters

characters.
data Opt. Object Response data.

ModelData Opt. String Human body modeling data.
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"ModelData": "test"
}
}
389
5.10.3 POST /artemis/api/body/v1/application/captureSearch

Get matched human bodies in a specified time period by a specified camera by body picture
comparison according to the human body modeling data, which is the third part of search for
matched human bodies on Intelligent Fusion Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/body/v1/application/captureSearch
Request Parameters

Type
'/\:*?"<>|
intelligentServ Req. String Body ID of Intelligent Fusion Server
is 32.
modeldata Req. String Body Human body modeling data.
yyyy-MMdd'T'HH:
26T15:00:00 + 08:00. And the
characters.
yyyy-MMdd'T'HH:
26T15:00:00 + 08:00. And the
390

Type
characters.
similarity Req. String Body Similarity of the searched
pictures. The maximum length
is 32.
sortType Req. String Body Sort type of search results: sort
by time or sort by similarity.
maxResults Req. Number Body Max. number of search results.
searchResultP Opt. Number Body The start position of the search
osion result in the result list.
modelMaxNu Opt. Number Body Max. number of returned
m models. The max number is
100.
Request Example
{
"cameraIndexCodes": "1,2,3",
"modelData": "test",
"startTime": "2022-08-13T17:30:08+08:00",
"endTime": "2022-08-13T17:30:08+08:00",
"similarity": "0.89",
"sortType": "time",
"maxResults": 100,
"searchResultPosition": 0,
"modelMaxNum": 100
}
Response Parameters

391

characters.

totalNum Req. Number Number of matched human bodies.
targetInfo Opt. targetInfo [] Searched human body information.
See details in bodyTargetInfo .
Response Example
{
"data": {
"totalNum": 1,
"targetInfo": [
{
"monitorPointIndexCode": "1",
"captureTime": "2022-05-03T17:30:08+08:00",
"similarity": "0.89",
"picUrl": "test",
"subPicUrl": "test",
"targetRect": {
"height": "0.89",
"width": "0.2",
"x": "0.15",
"y": "0.21"
},
"gender": 0,
"bag": 0,
"jacketType": 0,
"trousersType": 0,
"ageGroup": 0,
"hairStyle": 0,
"jacketColor": 0,
"trousersColor": 0,
"things": 0,
392
"mask": 0
}
]
}
}
5.10.4 POST /artemis/api/frs/v1/application/pictureRecognitionModel

Detect and model faces in the picture encoded by Base64 and get the modeling data, which is the
first part of search for matched faces on Intelligent Fusion Server. Multiple faces in the picture can
be detected and the modeling data for different faces can be identified by the corresponding
recognized coordinates.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/application/pictureRecognitionModel
Request Parameters

Type
'/\:*?"<>|
is 32.
Base64.
Request Example
{
"pictureData": "base64"
}
393
Response Parameters

characters.

targets Req. faceTargets[] Face modeling data. See details in
faceTargets .
Response Example
{
"code": "0",
"msg": "success",
"data": {
"targets": [
{
"targetModelData": "test",
"faceRect": {
"height": "0.89",
"width": "0.15",
"x": "0.12",
"y": "0.21"
}
}
]
}
}
394
5.10.5 POST /artemis/api/frs/v1/application/captureSearch

Get matched faces in a specified time period by a specified camera by face picture comparison
according to the face modeling data, which is the second part of search for matched faces on
Intelligent Fusion Server.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/frs/v1/application/captureSearch
Request Parameters

Type
'/\:*?"<>|
is 32.
targetModelD Req. String Body Face modeling data.
ata
maxResults Req. Number Body Max. number of search results.
yyyy-MMdd'T'HH:
26T15:00:00 + 08:00. And the
characters.
yyyy-MMdd'T'HH:
395

Type
26T15:00:00 + 08:00. And the
characters.
similarityMin Req. Number Body Min. similarity of the searched
pictures.
similarityMax Req. Number Body Max. similarity of the searched
pictures.
sortType Req. String Body Sort type of search results: sort
by time or sort by similarity.
searchResultP Opt. Number Body The start position of the search
osion result in the result list.
modelMaxNu Opt. Number Body Max. number of returned
m models. The max number is
100.
Request Example
{
"cameraIndexCodes": "1,2,3",
"targetModelData": "test",
"maxResults": 100,
"startTime": "2022-08-15T17:30:08+08:00",
"endTime": "2022-08-18T17:30:08+08:00",
"similarityMin": "0.01",
"similarityMax": "0.98",
"sortType": "time",
"searchResultPosition": 0,
"modelMaxNum": 100
}
Response Parameters

396

characters.

totalNum Req. Number Number of match results from face
picture comparison.
targets Opt. targetInfo [] Information of matched faces. See
details in faceTargetInfo .
Response Example
{
"code": "0",
"msg": "Success",
"data": {
"totalNum": 1,
"targets": [
{
"code": 1,
"captureTime": "2022-05-03T17:30:08+08:00",
"monitorPointIndexCode": "1",
"picUrl": "test",
"subpicUrl": "test",
"similarity": 1,
"faceRect": {
"height": "0.8",
"width": "0.3",
"x": "0.21",
"y": "0.12"
},
"currTemperature": "36.7",
"thermometryUnit": 0,
"mask": 1,
"gender": 1,
397
"glasses": 1,
"smile": 1,
"ageGroup": 1
}
]
}
}
5.11 Digital Signage API
5.11.1 POST /artemis/api/focsign/v1/material/dataSource/search

Search for data source.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/focsign/v1/material/dataSource/search
Request Parameters

Type
'/\:*?"<>|
sourceType Req. String Body Data source type: "push" (auto
push data source), "pull" (third
party database).
dataType Req. String Body Data type: "pic" (picture),
"character" (text), "table"
(table data).
sourceFrom Req. String Body Where the source is from:
"inner" (internal), "custom"
(customized), "all".
Request Example
{
"sourceType": "push",
"dataType": "character",
398
"sourceFrom": "all"
}
Response Parameters

characters.
data Req. Object Data source list. See details in
dataSourceData .
Response Example
{
"code": "0x0190020f",
"msg": "Success",
"data": {
"total": 1,
"pageSize": 1,
"pageNo": 0,
"list": [
{
"sourceName": "testName",
"sourceID": "UUID",
"materialNo": 185,
"sourceType": "pull",
"dataType": "pic",
"sourceFrom": "custom"
}
]
}
}
5.11.2 POST /artemis/api/focsign/v1/material/dataSource/update

Update data source.
399
Request URL
https://[serverAddress]:[serverPort]/artemis/api/focsign/v1/material/dataSource/update
Request Parameters

Type
'/\:*?"<>|
sourceID Req. String Header UUID for data source.
dataSourceDat Req. Object Body Message of data source
a update. See details in
dataSourceData .
Request Example
{
"dataUpdateType": "cover",
"maxMaterialNum": 2,
"characterInfo": {
"contentList": [
{
"id": 1,
"content": "1111",
"playTime": 1
}
]
}
}
Response Parameters

400

characters.
Response Example
{
"code": "0x0190020f",
"msg": "Success"
}
5.11.3 POST /artemis/api/focsign/v1/material/dataSource/update/batch

Batch update data sources.
Request URL
https://[serverAddress]:[serverPort]/artemis/api/focsign/v1/material/dataSource/update/batch
Request Parameters

Type
'/\:*?"<>|
dataSourceBat Req. Object Body Message of data resource
chUpdateList update in a batch. See details in
dataSourceBatchUpdateList .
Request Example
{
"dataSourceBatchUpdateList": [
{
"dataSourceUUID": "1",
401
"dataUpdateType": "cover",
"maxMaterialNum": 2,
"characterInfo": {
"contentList": [
{
"id": 1,
"content": "1111",
"playTime": 1
}
]
}
}
]
}
Response Parameters

characters.
Response Example
{
"code": "0x0190020f",
"msg": "Success"
}
402
Appendix A. Appendixes
A.1 Object Description
A.1.1 AccessLevel
The table here shows the visitor's access permission.
Table A-1 AccessLevel Object Description

id Req. Number The access level ID.
baseInfo Req. BaseInfo The basic information about the
access level.
A.1.2 AcsDevInfo
The table here shows the information of an access control device.
Table A-2 AcsDevInfo Object Description

acsDevIndexCode Opt. String Access control device ID, which
acsDevName Opt. String Access control device name, which
acsDevIp Req. String IP address of access control device.
acsDevPort Req. String Port No. of access control device.
acsDevCode Opt. String Serial No. of access control device,
which consists of up to 16 characters.
treatyType Opt. String Transfer protocol types, i.e., "hiksdk_
net" (Hikvision Private Protocol), and
"ehome_reg" (ISUP-Intelligent
Security Uplink Protocol).
403

status Opt. Number Status of the access control device: 0-
unknown, 1-online, 2-offline.
timeZone Opt. Object Time zone information, returned for
getting the information of an access
control device. See details in
TimeZoneInfo .
A.1.3 AlarmInputInfo
The table here shows the alarm input information.
Table A-3 AlarmInputInfo Object Description

alarmInputIndexC Opt. String Alarm input ID, which consists of up
alarmInputName Opt. String Alarm input name, which consists of
regionIndexCode Opt. String Area ID, which consists of up to 64
characters.
devIndexCode Opt. String Device ID, which consists of up to 64
characters.
devResourceType Opt. String Device resource type, i.e., "acsDevice"
(access controller), "encodeDevice"
(encoding device), "alarmDevice"
(alarm device), and "mobileDevice"
(on-board device). And the field can
networkStatus Opt. number Alarm input status: 0-unknown, 1-
online, 2-offiline.
A.1.4 AlarmOutputInfo
The table here shows the alarm output information.
404
Table A-4 AlarmOutputInfo Object Description

alarmOutputInde Opt. String Alarm output ID, which consists of up
xCode to 64 characters.
alarmOutputNam Opt. String Alarm output name, which consists of
e up to 32 characters.
characters.
devIndexCode Opt. String Device ID, which consists of up to 64
characters.
devResourceType Opt. String Device resource type, i.e., "acsDevice"
(access controller), "encodeDevice"
(encoding device), "alarmDevice"
(alarm device), and "mobileDevice"
(on-board device). And the field can
status Opt. Number Alarm output status: -1 (unknown), 0
(disabled), 1 (enabled).
A.1.5 ApplicationErrorResult
The table here shows the applying failure information.
Table A-5 ApplicationErrorResult Object Description

pageSize Opt. Number Page size. The maximum length is 64
bytes.
pageNo Opt. Number Number of pages.
applicationFailCo Opt. Number Number of failures to apply data.
unt
list Req. Array List of device error information.
list[0] Req. Object Error information of a device in the
list. See details in DeviceError .
405
A.1.6 BaseInfo
The table here shows the basic information.
Table A-6 BaseInfo Object Description

fullName Opt. String Name, the maximum length is 128
characters.
A.1.7 bodyRect
The table here shows information of the detected human body.
Table A-7 bodyRect Object Description

of value: [0.000, 1.000].
Range of value: [0.000, 1.000].
A.1.8 bodyTargetInfo
The table here shows information of target human body.
406
Table A-8 bodyTargetInfo Object Description

monitorPointInde Req. String Camera serial No. The maximum
xCode length is 32.
captureTime Req. String Capture time. The maximum length is
64.
similarity Req. String Similarity of the searched pictures.
picUrl Req. String URL for downloading the full picture.
subPicUrl Req. String URL for downloading the thumbnail.
targetRect Req. Object Normalized x-coordinate from the
[0.000, 1.000].
of value: [0.000, 1.000]. The
Range of value: [0.000, 1.000]. The
gender Opt. Enum Gender: 0-unknown gender, 1-male,
2-female.
bag Opt. Enum With backpack or not: 0-unknown, 1-
no, 2-yes.
jacketType Opt. Enum Top type: 0-unknown, 1-short sleeves,
2-long sleeves.
407

trousersType Opt. Enum Bottom type: 0-unknown, 1-shorts, 2-
trousers, 3-skirt.
ageGroup Opt. Enum Age group: 0-unknown, 1-teenager, 2-
young adult, 3-middle age, 4-the
elderly, 5-infant, 6-child, 7-early
youth, 8-prime, 9-middle to old age.
hairStyle Opt. Enum Hairstyle: 0-short hair, 1-long hair, 2-
unknown.
jacketColor Opt. Enum Top color: 0-unknown, 1-white, 2-
gray, 3-red, 4-dark blue, 5-blue, 6-
yellow, 7-brown, 8-pink, 9-purple, 10-
dark gray, 11-cyan, 12-orange, 13-
mixture, 14-green, 15-silver, 16-black.
trousersColor Opt. Enum Bottom color: 0-unknown, 1-white, 2-
gray, 3-red, 4-dark blue, 5-blue, 6-
yellow, 7-brown, 8-pink, 9-purple, 10-
dark gray, 11-cyan, 12-orange, 13-
mixture, 14-green, 15-silver, 16-black.
things Opt. Enum Carrying things or not: 0-unknown, 1-
no, 2-yes.
mask Opt. Enum Wear mask or not: 0-unknown, 1-no,
2-yes.
A.1.9 CameraInfo
The table here shows the information of a camera.
Table A-9 CameraInfo Object Description

cameraIndexCode Opt. String Camera ID, which consists of up to 64
characters.
cameraName Opt. String Camera name, which consists of up to
32 characters.
capabilitySet Opt. String Capability set, i.e., "vss" (video
capability), "event_veh" (vehicle
408

capture capability), "gis" (field of view
capability), "event_heat" (thermal
capability), "event_pdc" (people
counting capability), and "ptz" (PTZ
capability). See details in Capability
Set .
encodeDevIndexC Opt. String Encoding device ID, which consists of
ode up to 64 characters.
devResourceType String Device resource type (encodeDevice,
acsDevice, mobileDevice). See details
in Resource Types / Resource
Permission Code .
devIndexCode String Device ID, which is valid for non-
encoding devices.
recordType Opt. String Recording type, i.e., "0" (main
recording) and "1" (auxiliary
recording). And this field can contain
up to 32 characters. See details in
Recording Type .
recordLocation Opt. String Storage location of video files, i.e., "0"
(central storage), "1" (device storage),
"2" (central cluster storage). And this
field can contain up to 32 characters.
See details in Recording Storage
Location .
regionIndexCode Opt. String Area ID, which consists of up 64
characters.
status Opt. Number Camera status, i.e., 0-unknown, 1-
online, 2-offline.
siteIndexCode Opt. String Site ID, which consists of up to 64
characters.
treatyType Opt. String Currently, this extension field is
reserved.
Transfer protocol types, i.e., "hiksdk_
net" (Hikvision Private
Protocol),"ehome_reg" (Hikvision
409

Intelligent Security Uplink Protocol),
and "onvif_net" (ONVIF Protocol).
And this field can contain up to 32
characters.
See details in Access Protocol of
Device .
treatyTypeName Opt. String Currently, this extension field is
reserved.
Transfer protocol name, which
A.1.10 CameraRecordStatus
The table shows the storage status of a camera linked to the specific Storage Server.
Table A-10 CameraRecordStatus Object Description

cameraIndexCode Opt. String Camera ID, which consists of up to 64
characters.
cameraName Opt. String Camera name, which consists of up to
64 characters.
deviceIp Opt. String Device IP address, and the maximum
length is 64 bytes.
siteName Opt. String Site name, which consists of up to 64
characters.
regionName Opt. String Area name, which consists of up to 64
characters.
recordingSchedul Opt. String Recording schedule name, which
eName consists of up to 32 characters.
storageType Opt. Number Storage type: 0-unknown, 1-
scheduled video storage, 2-ANR video
storage, 3-picture storage.
410

recordingStatus Opt. Number Recording status: 0-recording, 1-not
record, 2-recording exception, 3-
searching failed, 4-unknown.
2-offline.
A.1.11 Card
The table here shows the information of a card .
Table A-11 Card Object Description

cardNo Opt. String Card No.
A.1.12 CertificateStatus
The table here shows the status information of applying visitor's credential to device.
Table A-12 CertificateStatus Object Description

type Req. Number Credential type: 0-physical card, 1-
fingerprint, 2-face picture, 3-iris.
id Req. Number Credential ID.
status Req. Number Status of credential application: 0-
applied, 1-to be applied, 2-applying
failed.
errorMordule Req. Number The module where the application
failed or error occurred.
errorCode Req. Number Error code of the failed application.
A.1.13 characterInfo
The table here shows the text content information.
411
Table A-13 characterInfo Object Description

contentList Req. Array Text content list.
id Req. Number Text content ID.
content Req. String Text content.
playTime Req. Number Display duration of text content.
A.1.14 CustomField
The table here shows the custom information about a person.
Table A-14 CustomField Object Description

id Opt. String Custom feature ID.
customFiledName Opt. String Custom feature name, which consists
customFieldType Opt. Number Text type: 0 (normal text, which
consists of 0 to 128 characters and
cannot contain ' / \ : * ? " < > |), 1
(numeric text, which consists of up to
32 digits), 2 (date text, its format is
YYYY/MM/DD hh:mm:ss) , 3 (single
selection).
customFieldValue Opt. String Value of the custom feature, which
When the value of customFieldType
is 3, this parameter indicates the
preset value ID of the CustomField
object.
presetValueList Opt. Array Preset value list.
presetValueList[0] Opt. PresetValue Information about a preset value in
the list.
412

isPublic Opt. Bool False-private (by default), true-public.
isShow Opt. Bool False-not displayed in the person list,
trued-displayed in the person list (by
default).
A.1.15 dataSourceBatchUpdateList
The table here shows the information of data resource update in a batch.
Table A-15 dataSourceData Object Description

dataSourceBatch Req. Array Information of data resource update
UpdateList in a batch.
dataSourceUUID Req. String Data source UUID.
dataType Req. String Data source type: "pic" (picture),
"character" (text), "table" (table).
dataUpdateType Req. String Update type: "cover" (overwrite),
"add".
maxMaterialNum Req. Number Number of a single data source
cached in the digital signage terminal.
This node is valid when
dataUpdateType is "add".
picInfo Opt. Object Picture information. This node is valid
when dataType is "pic". See details in
picInfo .
characterInfo Opt. Object Text content information. See details
in characterInfo .
tableInfo Opt. Object Table information. See details in
tableInfo .
A.1.16 dataSourceData
The table here shows the information of data resource update.
413
Table A-16 dataSourceData Object Description

dataType Req. String Data source type: "pic" (picture),
"character" (text), "table" (table).
dataUpdateType Req. String Update type: "cover" (overwrite),
"add".
maxMaterialNum Req. Number Number of a single data source
cached in the digital signage terminal.
This node is valid when
dataUpdateType is "add".
picInfo Opt. Object Picture information. This node is valid
when dataType is "pic". See details in
picInfo .
characterInfo Opt. Object Text content information. See details
in characterInfo .
tableInfo Opt. Object Table information. See details in
tableInfo .
A.1.17 DeviceError
The table here shows the error information of a device.
Table A-17 DeviceError Object Description

deviceName Opt. String Device name. The maximum length is
32 bytes.
errorList Opt. Array Error details list.
errorList[0] Opt. Object Details of an error in the list. See
details in RelatedErrorInfo .
A.1.18 DoorControlResult
The table here shows the information of an access point control result.
414
Table A-18 DoorControlResult Object Description

doorIndexCode Req. String Access point ID, which consists of up
to 64 characters.
controlResultCod Req. Number Control status code of access point,
e i.e., 0-succeeded, other codes-failed
(refer to Status or Error Code for
details).
controlResultDesc Opt. String Control status description of access
point, refer to Status or Error Code for
details.
A.1.19 DoorInfo
The table here shows the information of an access point.
Table A-19 DoorInfo Object Description

doorIndexCode Opt. String Access point ID, which consists of up
to 64 characters.
doorName Opt. String Access point name, which consists of
doorNo Opt. String Access point No. (or door No.), which
doorState Opt. Number Door statuses: 0-door remain open, 1-
door closed, 2-door open, 3-door
remain closed, 4-offline.
acsDevIndexCode Opt. String Access control device ID, which
characters.
A.1.20 ElementDetail
The table here shows the information of access level application information.
415
Table A-20 ElementDetail Object Description

elementID Req. Number Device ID.
Baseinfo Req. String[] Basic device information. See details
in ElementDetailBaseInfo .
ElementStatus Req. String[] Status information of the device. See
details in ElementStatus .
CertificateStatusL Req. CertificateStatusLi Status information of applying
ist st[] visitor's credential to device. See
details in CertificateStatus .
A.1.21 ElementDetailBaseInfo
The table here shows the information of the device which the access level is applied to.
Table A-21 ElementDetailBaseInfo Object Description

elementName Req. String Device name.
elementType Req. Number Device type: 6-door, 11-floor.
elementNetwork Req. Number Network status of device: 0-offline, 1-
online.
A.1.22 ElementStatus
The table here shows the status information of the device which the access level is applied to.
Table A-22 ElementStatus Object Description

elementStatus Req. Number Application status of the access level
to the device.
elementErrorMor Req. Number The module where the application
dule failed or error occurred.
elementErrorCod Req. Number Error code of the failed application.
e
416
A.1.23 EncodeDevInfo
The table here shows the information of an encoding device.
Table A-23 EncodeDevInfo Object Description

encodeDevIndexC Optional String Encoding device ID, which consists of
ode up to 64 characters.
encodeDevName Optional String Encoding device name, which consists
encodeDevIp Required String IP address of encoding device
encodeDevPort Required String Port No. of encoding device.
encodeDevCode Optional String Serial No. of encoding device, which
treatyType Optional String Transfer protocol types, i.e., "hiksdk_
net" (Hikvision Private
Protocol),"ehome_reg" (Hikvision
Intelligent Security Uplink Protocol),
and "onvif_net" (ONVIF Protocol).
status Opt. Number Status of the encoding device: 0-
unknown, 1-online, 2-offline.
TimeZoneInfo .
A.1.24 eventLabelList
The table here shows information of event tags.
417
Table A-24 eventLabelList Object Description

labelCode Req. String Tag ID. The maximum length of this
field is 32.
labelEvent Req. Number Tag type: 2 (person-detection tag), 4
(vehicle-detection tag).
startTime Req. String Start time of the tag, which is in ISO
8601 standard time format: yyyy-
MMdd'T'HH: mm:ss.SSSzzz, e.g.,
2018-07-26T15:00:00 + 08:00. And
the time consists of up to 64
characters.
endTime Req. String End time of the tag, which is in ISO
8601 standard time format: yyyy-
MMdd'T'HH: mm:ss.SSSzzz, e.g.,
2018-07-26T15:00:00 + 08:00. And
characters.
A.1.25 eventList
The table here shows information of the event.
Table A-25 eventList Object Description

eventCode Req. Number Event ID.
eventType Req. Number Event type.
eventName Req. String Event name. The maximum length is
256.
rawEventName Req. String Original event name. The maximum
length is 256.
description Req. String Event description.
eventCategory Req. Number Event category: 100651-HEOP event,
100652-AIOP event.
418
A.1.26 EventPic
The table here shows the event picture information.
Table A-26 EventPic Object Description

eventPicUri Opt. String URL of the event picture, the
picType Opt. Number Picture type: 1 (picture reported by
the device), 2 (picture captured by
linkage).
A.1.27 EventRecord
The table here shows the information of an event record.
Table A-27 EventRecord Object Description

eventIndexCode Req. String Event ID, which consists of up to 64
characters.
eventType Req. String Event type, refer to Event Types or
srcType Req. String Event source type: "acsDevice"
(access controller), "door" (access
point), "encodeDevice" (encoding
device), "camera", "ioIn" (alarm
input), "generalEventRule" (general
event). And the field can contain up to
64 characters. Refer to Event Types or
srcIndex Req. String Event source No., which consists of up
to 64 characters.
subSrcType Opt. String Event source type, which is available
for search of license plate matched or
mismatched event. The maximum
length is 64 bytes.
419

subSrcIndex Opt. String Event source No., which is available
for search of license plate matched or
mismatched event. Each two No.
should be separated by comma. The
description Opt. String Event description information, which
startTime Req. String Event occurred time, which is in ISO
8601 standard time format: yyyy-MM-
ddTHH:mm:ss+current zone, e.g.,
2018-07-26T15:00:00+08:00. And the
time consists of up to 64 characters.
stopTime Opt. String Stop time of event, which is in ISO
2018-07-26T15:00:00+08:00. And the
eventPicUri Opt. String Event picture URL, and the maximum
eventPicList Opt. Array Event picture list.
eventPicList[0] Opt. EventPic Event picture information.
linkCameraIndexC Opt. String The linked camera ID, which consists
ode of up to 1024 characters.
A.1.28 face
The table here shows the information of a face.
Table A-28 face Object Description

faceData Req. String A data string of face picture encoded
by Base64.
420
A.1.29 FaceGroupInfo
The table here shows the information of a face comparison group.
Table A-29 FaceGroupInfo Object Description

indexCode Req. String Face comparison group ID, and it
name Req. String Name of face comparison group,
description Req. String Description information, and it can
A.1.30 FaceInfo
The table here shows the information of a face.
Table A-30 FaceInfo Object Description

personGivenNam Req. String Person's given name; the total length
e of given name and family name
cannot be longer than 255 characters.
personFamilyNa Req. String Person's family name; the total length
me of given name and family name
cannot be longer than 255 characters.
sex Opt. String Gender of the person linked with the
face information: "1"-male, "2"-
female, "0"-unknown.
A.1.31 facePic
The table here shows the information of a face picture.
421
Table A-31 facePic Object Description

faceBinaryData Opt. String A binary data string of face picture,
which is encoded by Base64. The
picture size must be between 10 KB
and 100 KB, and the format should be
JPG.
A.1.32 FaceMatchRecord
The table here shows the face comparison information.
Table A-32 FaceMatchRecord Object Description

recordIndexCode Req. String Record ID.
cameraInfo Req. Object Camera information.
cameraIndexCode Req. String Camera ID.
cameraName Req. String Camera name.
faceGroupInfo Req. Object Face comparison group information.
faceGroupIndexCodes Req. String Face comparison group ID.
faceGroupName Req. String Face comparison group name.
PersonInfo Req. Object Face picture coordinates.
personId Req. String Person ID, the maximum length is 64 characters.
personCode Req. String Person No., the maximum length is 16
characters.
personName Req. String Name, the maximum length is 512 characters.
personFamilyName Req. String Person's family name, the maximum length is
256 characters.
personGivenName Req. String Person's given name, the maximum length is 256
characters.
similarity Req. Number Similarity between the picture in the library and
the captured picture.
faceTime Req. String Time when the picture is captured.
422

snapFacePicUrl Req. String URL of the captured picture.
faceRect Req. Object Face coordinate information.
height Req. Number Height.
width Req. Number Width.
x Req. Number X coordinate.
y Req. Number Y coordinate.
bkgPicUrl Opt. String URL of the background picture.
bkgRect Opt. Object Coordinate information of the background
picture.
height Opt. Number Height.
width Opt. Number Width.
x Opt. Number X coordinate.
y Opt. Number Y coordinate.
temperatureData Req. String Temperature.
temperatureStatus Req. Number Temperature status: -1 (all), 0 (unknown), 1
(normal), 2 (exception).
wearMaskStatus Req. Number Whether a wearing mask: -1 (all), 0 (unknown), 1
(yes), 2 (no).
gender Opt. Number Gender: 0 (unknown), 1 (male), 2 (female).
ageGroup Opt. Number Age group.
glasses Opt. Number Whether wearing glasses: 0 (unknown), 1 (yes),
2 (no), 3 (sunglasses).
smile Req. Number Smile or not: 1 (unknown), 2 (no), 3 (smile).
A.1.33 faceTargetInfo
The table here shows the information of the target face.
423
Table A-33 faceTargetInfo Object Description

code Req. Number Serial No. The maximum length is 32.
captureTime Req. String Capture time. The maximum length is
64.
monitorPointInde Req. String Camera serial No. The maximum
xCode length is 32.
picUrl Req. String URL for downloading the full picture.
subPicUrl Req. String URL for downloading the thumbnail.
similarity Req. String Similarity of the searched pictures.
faceRect Req. Object Coordinate box for the face.
Normalized x-coordinate from the
[0.000, 1.000].
height Req. String Height of detected face in the picture,
normalized to [0.000, 1.000]. The
width Req. String Width of detected face in the picture,
of value: [0.000, 1.000]. The
currTemperature Opt. String Face temperature. The maximum
length is 32.
thermometryUnit Opt. Enum Temperature unit: 0-Celsius, 1-
Fahrenheit, 2-Kelvin.
424

mask Opt. Enum Wear mask or not: 0-unknown, 1-no,
2-yes.
gender Opt. Enum Gender: 0-unknown gender, 1-male,
2-female.
glasses Opt. Enum Wearing glasses or not: 0-no, 1-
wearing sunglasses, 2-unknown, 2-
yes.
smile Opt. Enum Smiling or not: 0-no, 1-unknown, 2-
yes.
ageGroup Opt. Enum Age group: 0-teenager, 1-infant, 2-
child, 3-middle age, 4-middle to old
age, 5-the elderly, 6-prime, 7-early
youth, 8-unknown, 9-young adult.
A.1.34 faceTargets
The table here shows the information of face modeling.
Table A-34 faceTargets Object Description

targetModelData Req. String Face modeling data.
faceRect Req. Object Coordinate box for the face.
Normalized x-coordinate from the
[0.000, 1.000].
height Req. String Height of detected face in the picture,
width Req. String Width of detected face in the picture,
425

of value: [0.000, 1.000]. The
A.1.35 FingerPrint
The table here shows the information of a fingerprint.
Table A-35 FingerPrint Object Description

fingerPrintIndexC Opt. String Fingerprint ID, which consists of up to
ode 64 characters.
fingerPrintName Opt. String Fingerprint name, which consists of
fingerPrintData Opt. String Fingerprint data, which consists of up
to 1024 characters. If this field is not
configured, the previous fingerprint
data will be used.
relatedCardNo Opt. String The linked card No. The maximum
length is 20 bytes.
A.1.36 fingerPrintUpdateResult
This table shows the a fingerprint updating result.
426
Table A-36 fingerPrintUpdateResult Object Description

fingerPrintName Req. String Fingerprint name. The maximum
length is 64 bytes.
errorCode Req. String Error code returned when failed. See
details in Status or Error Code .
errorDesc Opt. String Error description. See details in Status
or Error Code .
A.1.37 FloorInfo
The table here shows the floor information.
Table A-37 FloorInfo Object Description

floorIndexCode Req. String Floor ID.
floorName Req. String Floor name.
parkingLotIndexC Req. String Parking lot ID.
ode
parkingLotName Req. String Parking lot name.
A.1.38 FloorOverViewInfo
The table here shows the floor overview.
Table A-38 FloorOverViewInfo Object Description

ode
totalSpaceNum Req. Number Total number of parking spaces on the
floor.
427

freeSpaceNum Req. Number Number of vacant parking spaces on
the floor.
spaceTypeOverVi Req. Array List of all parking space types.
ew
spaceTypeOverVi Req. SpaceTypeOverVi Information about a parking space
ew[0] ewInfo type.
A.1.39 ForbiddenVehicleInfo
The table here shows information of the vehicle in the blocklist.
Table A-39 ForbiddenVehicleInfo Object Description

vehicleIndexCode Req. String Blocklist vehicle ID, which consists of
plateLicense Req. String License plate number, which consists
of 1 to 32 characters, but cannot
contain special characters like ' / \ :
* ? " < > |.
personGivenNam Req. String Person's given name, which consists
e of 1 to 16 characters, but cannot
* ? " < > |.
personFamilyNa Req. String Person's family name, which consists
me of 1 to 16 characters, but cannot
*?"<>|
phoneNo Req. String Contact number, which can contain
numbers from 0-9, and special
characters ＋ and －. The maximum
length is 32.
description Req. String Vehicle description, which consists of
1 to 128 characters, but cannot
*?"<>|
428

effectiveDate Req. String Start time of blocking, in ISO 8601
format, which is represented by
"yyyy- MM-ddTHH:mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String End time of blobking, in ISO 8601
time zone", e.g., "2018-07-
26T15:00:00 + 08:00".
A.1.40 GeneralEventRule
The table here shows information of generic event rule.
Table A-40 GeneralEventRule Object Description

generalEventRuleI Opt. String Generic event rule ID, which consists
generalEventRule Req. String Name of the generic event rule, which
Name consists of up to 32 characters.
transportType Req. Number Transmission type: 0-TCP, 1-UDP.
matchType Req. Number Match type: 0-search (the received
data package must contain the text
specified in expression, but may also
have more content), 1-match (the
received data package must contain
exactly the text specified in
expression, and nothing else). The
expression Req. String Description of the regular expression,
characters.
regularExpression Req. String Regular expression of the generic
event rule.
429
A.1.41 gpsInfo
The table here shows the GPS information.
Table A-41 gpsInfo Object Description

occurTime Req. String GPS report time. The maximum
longitude Req. Float Longitude. The maximum length is 16
characters.
latitude Req. Float Latitude. The maximum length is 16
characters.
* 100; [0, 36000)).
gpsDisplay Req. String Displayed GPS information. The
directionDisplay Req. String Displayed direction ("North",
16 characters.
A.1.42 HDDInfo
The table shows the information of a HDD.
Table A-42 HDDInfo Object Description

poolID Opt. String Resource pool ID, which consists of up
to 32 characters.
poolName Opt. String Resource pool name, which consists
430

Status Opt. Number HDD status. Currently, this parameter
is reserved.
Capacity Opt. Number HDD capacity, unit: MB.
FreeSpace Opt. Number Free space of HDD, unit: MB.
UsedSpace Opt. Number HDD usage, unit: MB.
A.1.43 IntelligentServerInfo
The table shows the information of an Intelligent Server.
Table A-43 IntelligentServerInfo Object Description

intelligentServerI Opt. String Intelligent Server ID, which consists of
ndexCode up to 64 characters.
intelligentServer Opt. String Intelligent Server name, which
Name consists of up to 64 characters.
intelligentServerI Opt. String IP address of Intelligent Server, whose
p maximum length is 64 bytes.
status Opt. Number Network status: 0-unknown, 1-online,
2-offline.
A.1.44 LiveViewUrlInfo
The table shows the information of live view URL.
Table A-44 LiveViewUrlInfo Object Description

url Req. String Streaming URL, which consists of up
to 128 characters.
authentication Opt. String The authentication information for
getting stream, which contains user
name, password, and token
information. And this field can contain
431
A.1.45 MobileDeviceInfo
The table here shows the on-board device information.
Table A-45 MobileDeviceInfo Object Description

mobileDevIndexC Opt. String On-board device ID. The maximum
ode length is 64 characters.
mobileDevName Opt. String On-board device name. The maximum
mobileDevIp Opt. String On-board device IP. The maximum
mobileDevPort Opt. String On-board device port. The maximum
mobileDevCode Opt. String On-board device No. The maximum
treatyType Opt. String Access protocol. The maximum length
is 16 characters. See details in Access
Protocol of Device .
status Opt. Number Online status (0-unknown, 1-online,
2-offline).
TimeZoneInfo .
A.1.46 MobilevehivleInfo
The table here shows the information of vehicles linked to on-board devices.
432
Table A-46 MobilevehivleInfo Object Description

exCode device. The maximum length is 128
characters.
mobilevehicleNa Req. String Name of vehicle linked to the on-
me board device. The maximum length is
256 characters.
DevIndexCode Req. String Device ID. The maximum length is 128
characters.
regionIndexCode Req. String Area ID. The maximum length is 128
characters.
status Req. Number Online status (0-unknown, 1-online,
2-offline).
plateNo Req. String License plate number of the vehicle.
personName Req. String Person name. The maximum length is
64 characters.
personFamilyNa Opt. String Family name of the person. The
me maximum length is 64 characters.
personGivenNam Opt. String Given name of the person. The
e maximum length is 64 characters.
phoneNo Opt. String Contact number. The maximum
vehicleColor Opt. Number Vehicle color. See details in Vehicle
Color .
vehicleType Opt. Number Vehicle type: 0-others, 1-small-sized
vehicle, 2-large-sized vehicle, 3-
motorcycle.
vehicleBrand Opt. Number Vehicle brand.
A.1.47 OrgInfo
The table here shows the information of an organization.
433
Table A-47 OrgInfo Object Description

orgIndexCode Opt. String Organization ID, which consists of up
to 64 characters.
orgName Opt. String Organization name, which consists of
parentOrgIndexC Opt. String Parent organization ID, which consists
ode of up to 64 characters.
A.1.48 ParkingFeeCalculate
The table here shows the information for parking fee calculation.
Table A-48 ParkingFeeCalculate Object Description

plateLicense Opt. String License plate number, the maximum
parkingInTime Req. String Time when the vehicle entered the
parking lot.
parkingDuration Opt. Number Total parking duration, unit: second.
feeRuleType Opt. Number parking fee type: 0-rule for temporary
vehicles, 1-rule for registered
vehicles, 2-rule for parking pass, 4-
rule for exceptional pass.
feeRuleIndexCod Opt. String Parking fee rule ID.
e
feeRuleName Opt. String Parking fee rule name.
fee Opt. String Parking fee.
A.1.49 ParkingFeeConfirm
The table here shows the information for parking fee confirmation.
434
Table A-49 ParkingFeeConfirm Object Description

fee Req. String Parking fee.
feeTime Req. String Time when fee is charged.
A.1.50 ParkingLotInfo
The table here shows the information about a parking lot.
Table A-50 ParkingLotInfo Object Description

ode
parentParkingLotI Opt. String Parent parking lot ID (if exists).
ndexCode
totalSpaceNum Req. Number Total number of parking spaces.
freeSpaceNum Req. Number Number of vacant parking spaces.
totalPermanentS Req. Number Total number of parking spaces for
paceNum registered vehicles.
freePermanentSp Req. Number Number of vacant parking spaces for
aceNum registered vehicles.
maxParkingTime Req. Number Max. parking duration (hour).
A.1.51 ParkingRecordInfo
The table here shows the information about a vehicle parking record.
Table A-51 ParkingRecordInfo Object Description

guid Req. Number Vehicle parking record ID.
ode
435

parkingSpaceSeri Req. String Parking space serial No.
al
plateLicense Req. String License plate number.
parkingStatusTyp Req. Number Status: 0 (parking), 1 (exited).
e
occurTime Req. String Time when the vehicle entered/exited
the parking space.
duration Opt. Number Parking duration (if the vehicle has
exited). The unit is second.
A.1.52 ParkingSpaceInfo
The table here shows the information about a parking space.
Table A-52 ParkingSpaceInfo Object Description

Name
spaceIndexCo Req. String Parking space ID.
de
floorIndexCod Req. String Floor ID.
e
spaceType Req. Number Parking space type: 1 (general),
2 (allowed), 3 (forbidden), 4
(charging), 5 (private), 6
(registered), 7 (temporary).
serial Req. String Parking space serial No.
status Req. Number Status: 0 (unknown), 1 (vacant),
2 (occupied), 3 (overtime
parking), 4 (parking violations).
plateNumber Req. String License plate number.
436

Name
creatTime Req. String Time when the current status
started.
duration Req. Number Duration of the current status.
parkingImage Req. String URL of the background picture.
Url
platenumberI Req. String URL of the license plate.
mageUrl
A.1.53 PassingRecordInfo
The table here shows the information about a vehicle passing record.
Table A-53 PassingRecordInfo Object Description

guid Req. String Vehicle passing record ID.
parkingLotInfo Req. Object Parking lot information.
ode
passagewayInfo Req. Object Entrance/exit information.
passagewayIndex Req. String Entrance/exit ID.
Code
passagewayName Req. String Entrance/exit name.
laneInfo Req. Object Lane information.
laneIndexCode Req. String Lane ID.
laneName Req. String Lane name.
direction Req. Number Direction: 1 (entry), 2 (exit).
personInfo Req. Object Vehicle owner information.
cardNum Req. Number ID number.
ownerName Req. String Owner name.
437

ownerPhoneNum Req. String Phone number.
carInfo Req. Object Vehicle information.
plateLicense Req. String License plate number.
carType Req. Number Vehicle type: 0 (Other), 1 (small-sized
vehicle), 2 (large-sized vehicle), 3
(bus), 4 (truck), 5 (sedan), 6 (minivan),
7 (small-sized truck).
ImageUrl Req. String URL of the vehicle picture.
EnterTime Req. String Time when the vehicle entered the
parking lot.
ExitTime Req. String Time when the vehicle exited the
parking lot.
allowType Req. Number Allow mode: 1 (manual), 2 (auto), 3
(not allowed).
allowResult Req. Number Whether the passing is allowed: 1
(allowed), 2 (not allowed).
A.1.54 PassVehicleRecord
The table here shows the information of a vehicle passing record.
Table A-54 PassVehicleRecord Object Description

crossRecordSysco Req. String Vehicle passing record ID, which
cameraIndexCode Req. String Camera ID, which consists of up to 64
characters.
plateNo Opt. String License plate number of vehicle,
ownerName Opt. String Vehicle owner name, which consists
contact Opt. String Contact number of vehicle owner,
438

vehicleColor Opt. Number Vehicle color: 0-other color, 1-white,
2- sliver, 3-grey, 4-black, 5-red, 6-dark
blue, 7- blue, 8-yellow, 9-green, 10-
brown, 11-pink, 12- purple.
vehicleType Opt. Number Vehicle type: 0-others, 1-small-sized
motorcycle.
country Opt. Number Country of the vehicle.
vehiclePicUri Opt. String Vehicle picture URL, which consists of
crossTime Opt. String Vehicle passed time, which is in ISO
2018-07-26T15:00:00+08:00. And the
createTime Opt. String Record created time, which is in ISO
2018-07-26T15:00:00+08:00. And the
vehicleDirectionT Opt. Number Driving direction: 0 (other directions),
ype 1 (downward, from far to near for the
camera), 2 (upward, from near to far
for the camera).
A.1.55 PatrolInfo
The table here shows the patrol information.
439
Table A-55 PatrolInfo Object Description

patrolName Req. String Patrol name, which consists of up to
128 characters.
patrolIndex Req. Number Patrol No., which is between 1 and 8.
And the No. consists of up to 64
characters.
patrolPointInfoLis Opt. Array Preset information list of the patrol.
t
patrolPointInfoLis Opt. Object Information of a preset in the list of
t[0] the patrol. Refer to PatrolPointInfo
for details.
A.1.56 PatrolPointInfo
The table here shows the information of a preset in the patrol.
Table A-56 PatrolPointInfo Object Description

presetIndex Req. Number Preset No., which is between 1 and
256. And the No. consists of up to 64
characters.
presetName Opt. String Preset name, which consists of up to
32 characters. This field is not Req.
when editing the preset, and it will
not be returned when searching
patrols, getting patrol information by
patrol No.
speed Req. Number Switching speed between each two
presets, which is between 1 and 40.
dwellTime Req. Number Dwell duration of a preset, which is
between 15 and 30.
440
A.1.57 PeopleCountInfo
This table shows people counting statistics information of an item.
Table A-57 PeopleCountInfo Object Description

time Opt. String Statistics time. The maximum length
is 64 bytes.
cameraIndexCode Opt. String Camera ID. The maximum length is 64
bytes.
exitNum Opt. Number Number of people exited.
enterNum Opt. Number Number of people entered.
A.1.58 PeopleCountingParam
The table here shows people counting parameters.
Table A-58 PeopleCountingParam Object Description

relatedResourceI Opt. RelatedResourceI Related resources.
nfoList nfo
A.1.59 PersonInfo
The table here shows the information of a person.
Table A-59 PersonInfo Object Description

personId Opt. String Person ID, which consists of up to 64
characters.
personCode Opt. String Person No., which consists of up to 16
characters.
personName Opt. String Person name, which consists of up to
512 characters.
441

personFamilyNa Opt. String Family name of the person, which
me consists of up to 256 characters.
personGivenNam Opt. String Given name of the person, which
gender Opt. Number Gender, i.e., 0-unknown, 1-male, 2-
female; and this field can contain up
to 32 characters.
orgIndexCode Opt. String Person's organization ID, which
fingerPrint Opt. Object Fingerprint information. See details in
FingerPrint .
phoneNo Opt. String Contact number, which consists of up
to 64 characters.
personPhoto Opt. Object Person picture information. See
details in PersonPhoto .
email Opt. String Email address of the person, which
remark Opt. String Remarks, which consists of up to 256
characters.
cards Opt. Object Card information. See details in Card .
beginTime Req. String Start time in ISO 8601 format, which
is represented by "yyyy-MM-
ddTHH:mm:ss+current time zone",
e.g., "2018-07-26T15:00:00 + 08:00".
The maximum length is 64 bytes.
endTime Req. String End time in ISO 8601 format, which is
e.g., "2018-07-26T15:00:00 + 08:00".
customFieldList Opt. Array List of custom information.
customFieldList[0 Opt. Object Custom information. See details in
] CustomField .
442
A.1.60 PersonInOutEvents
The table here shows the information of an access point event.
Table A-60 PersonInOutEvents Object Description

eventId Req. String Event ID, which consists of up to 32
characters including digits and lower-
case letters.
eventType Req. Number Decimal event type code, refer to
Event Types or Alarm Categories for
details.
eventTime Req. String Event occurred time, which is in ISO
2018-07-26T15:00:00+08:00. And the
deviceTime Opt. String Event occurred time (device time),
which is in ISO 8601 time format. The
personId Opt. String Person ID, which consists of up to 64
characters including digits, lower-case
letters, and dashes.
personName Opt. String Person name, which consists of 1 to
512 characters, but cannot contain
special characters like ' / \ : * ? " < > |
personFamilyNa Opt. String Family name of the person, which
me consists of 256 characters.
personGivenNam Opt. String Given name of the person, which
e consists of 256 characters.
doorName Opt. String Access point name, which consists of
1 to 32 characters, but cannot contain
special characters like ' / \ : * ? " < > |
doorIndexCode Opt. String Access control ID, which consists of up
to 64 characters including digits,
lower-case letters, and dashes.
443

cardNo Opt. String Card number, which consists of up to
32 characters.
checkInAndOutTy Opt. Number Attendance type, 0: unknown, 1:
pe check-in, 2: check-out, 3: break-out, 4:
break-in, 5: overtime-in, 6: overtime-
out.
picUri Opt. String Captured picture URI (a relative path).
You can call POST /
artemis/api/acs/v1/event/pictures
to get the picture data from the URI.
temperatureData Opt. String Temperature value. The maximum
length is 64 bytes.
temperatureStatu Opt. Number Temperature status: 0-unknown, 1-
s normal, 2-abnormal.
wearMaskStatus Opt. Number Wearing mask or not: 0-unknown, 1-
yes, 2-no.
readerIndexCode Opt. String Card reader ID, which consists of up
to 64 characters.
readerName Opt. String Card reader name, which consists of
A.1.61 PersonPhoto
The table here shows the information of a person picture.
Table A-61 PersonPhoto Object Description

picUri Opt. String Person picture URL, which consists of
A.1.62 picInfo
The table here shows the picture information.
444
Table A-62 picInfo Object Description

picUrlList Opt. Array Picture list.
id Req. Number Picture ID.
type Req. String Picture uploading format. Currently
only uploading via "data" is
supported.
data Req. String A binary data string of picture
encoded by Base64. This node is valid
when type is "data".
playTime Req. Number Display duration of the picture.
A.1.63 PlaybackUrlVideoInfo
The table shows the information of playback URL and video segment.
Table A-63 PlaybackUrlVideoInfo Object Description

list Req. Array Information list of video segments.
list[0] Req. Object Information of a video segment in the
list. See details in VideoInfo .
uuid Opt. String ID for searching by page. This UUID is
returned after the previous search
and it is used for the next search of
remaining videos. By default, it is
"null". And it consists of up to 64
characters.
to 128 characters.
445

recordLocation Opt. String Video storage location: "0"-central
storage (default), "1"-device storage,
"2"-central cluster storage. This field
can contain up to 32 characters.
A.1.64 PresetInfo
This table shows the information of a preset.
Table A-64 PresetInfo Object Description

presetName Req. String Preset name, which consists of up to
128 characters.
presetIndex Req. Number Preset No., which consists of up to
128 characters.
A.1.65 PresetValue
The table here shows the information about a preset value.
Table A-65 PresetValue Object Description

id Opt. String Preset value ID, which consists of up
to 64 characters.
value Opt. String Preset value, which consists of up to
32 characters.
A.1.66 PrivilegeGroupInfo
The table here shows access group information.
446
Table A-66 PrivilegeGroupInfo Object Description

privilegeGroupId Req. String Access level ID, which consists of up
to 64 characters.
privilegeGroupNa Req. String Access level name, which consists of
me up to 32 characters.
description Req. String Description, which consists of up to
128 characters.
timeSchedule Req. Object Time schedule template. See details
in TimeSchedule .
A.1.67 ReaderInfo
The table here shows card reader information.
Table A-67 ReaderInfo Object Description

indexCode Req. String Card reader ID, which consists of up
to 64 characters.
name Req. String Card reader name, which consists of
enable Opt. Number Whether to enable the card reader: 0-
disable, 1-enable. If this parameter
does not exist, it indicates that
configuring this item is not supported.
A.1.68 RealPeopleCountInfo
The table here shows the real-time statistics of a group.
447
Table A-68 RealPeopleCountInfo Object Description

time Opt. String Time, which consists of up to 64
characters.
resourceGroupIn Opt. String Resource group ID, which consists of
dexCode up to 64 characters.
resourceGroupNa Opt. String Resource group name, which consists
me of up to 64 characters.
exitNum Opt. Number Number of people who exited the
area.
enterNum Opt. Number Number of people who entered the
area.
limitNum Opt. Number Number threshold.
A.1.69 RecordOverview
The table here shows the record overview.
Table A-69 RecordOverview Object Description

eventIndexCode Req. String Event record ID. The maximum length
is 64 characters.
eventType Req. Number Event type. The maximum length is 16
characters.
mobilevehicleInd Req. String On-board vehicle ID. The maximum
plateNo Req. String License plate No. The maximum
ownerName Req. String Vehicle owner name. The maximum
regionName Req. String Area name. The maximum length is
64 characters.
occurTime Req. String GPS report time, in ISO 8601 format,
which is represented by "yyyy- MM-
448

e.g., "2018-07- 26T15:00:00 + 08:00".
longitude Req. String Longitude (integer; including negative
latitude Req. String Latitude (integer; including negative
* 100; [0, 36000)).
displayInfo Req. String Displayed GPS information, e.g., E120,
50, 20; N30, 50, 20. The maximum
directionInfo Req. String Direction information ("North",
16 characters.
A.1.70 RelatedResourceInfo
The table here shows related resources.
449
Table A-70 RelatedResourceInfo Object Description

resourceType Opt. Number Resource type: 1 (camera), 2 (door).
resourceIndexCod Opt. String Resource ID, the maximum length is
e 64 characters.
resourceName Opt. Number Resource name.
entryExitConfig Opt. Number Enter/exit direction: 1 (people
crossing along the entry direction (for
camera/door) will be calculated as
people entered this region), 2 (people
crossing along the entry direction (for
camera/door) will be calculated as
people exited this region).
A.1.71 RecordServerInfo
The table shows the information of a Storage Server.
Table A-71 RecordServerInfo Object Description

recordServerInde Opt. String Storage Server ID, which consists of
xCode up to 64 characters.
recordServerNam Opt. String Storage Server name, which consists
recordServerIp Opt. String IP address of Storage Server, whose
recordingStatus Opt. Number Video status: 0-unknown, 1-normal,
2-exception.
2-offline.
hddList Opt. Array HDD information list. This parameter
is valid only when getting the
information of a single Storage Server.
hddList[0] Opt. Object Information of a HDD, refer to
HDDInfo for details.
450
A.1.72 RegionInfo
The table here shows the information of an area.
Table A-72 RegionInfo Object Description

indexCode Opt. String Area ID, which consists of up to 64
characters.
name Opt. String Area name, which consists of up to 32
characters.
parentIndexCode Opt. String Parent area ID, which consists of up to
64 characters.
characters.
A.1.73 RelatedErrorInfo
The table here shows the details of an error.
Table A-73 RelatedErrorInfo Object Description

personName Opt. String Person name. The maximum length is
64 bytes.
resourceName Opt. String Resource name. The maximum length
is 32 bytes. For multiple names, each
two names should be separated by
comma.
errorItems Opt. String Error type: 0-device exception; 1-
incorrect card information; 2-
incorrect fingerprint information; 3-
incorrect face information; 4-incorrect
person information. For multiple
types, each two types should be
separated by comma.
451
A.1.74 ResourceGroupInfo
The table here shows information about a resource group.
Table A-74 ResourceGroupInfo Object Description

resourceGroupIn Opt. String Resource group ID, which consists of
dexCode up to 64 characters.
resourceGroupNa Opt. String Name of the resource group, which
siteIndexCode Opt. String Site ID.
peopleCountingP Opt. PeopleCountingP People counting parameters.
aram aram
A.1.75 SiteInfo
The table here shows the information of a site.
Table A-75 SiteInfo Object Description

characters.
siteName Opt. String Site name, which consists of up to 32
characters.
siteIp Req. String Site IP address.
sitePort Req. String Site port No.
description Opt. String Site description information, which
A.1.76 SpaceTypeOverViewInfo
The table here shows the information about a parking space type.
452
Table A-76 SpaceTypeOverViewInfo Object Description

typeIndexCode Req. String Parking space type ID.
typeName Req. String Name of the parking space type.
typeColor Req. String Color of the parking space type.
totalSpaceNum Req. Number Total number of parking spaces of the
type.
freeSpaceNum Req. Number Vacant number of parking spaces of
the type.
A.1.77 StatisticResult
The table here shows the statistics result.
Table A-77 StatisticResult Object Description

unApplicationCou Opt. Number Number of not applied attempts.
nt
applicationFailCo Opt. Number Number of failures to apply data.
unt
editAndUnApplic Opt. Number Number of edited and not applied
ationCount attempts.
A.1.78 StreamServerInfo
The table shows the information of a Stream Media Server.
Table A-78 StreamServerInfo Object Description

streamServerInde Opt. String Stream Media Server ID, which
xCode consists of up to 64 characters.
streamServerNa Opt. String Stream Media Server name, which
453

streamServerIp Opt. String IP address of Stream Media Server,
whose maximum length is 64 bytes.
totalStreamNum Opt. Number Total number of stream channels.
streamInNum Opt. Number Number of stream input channels.
streamOutNum Opt. Number Number of stream output channels.
status Opt. Number Network status: 0-exception, 1-
normal.
CPUUsage Opt. Number CPU usage of Stream Media Server,
which is represented by percentage.
RAMUsage Opt. Number RAM usage of Stream Media Server,
which is represented by percentage.
A.1.79 SubscriptionInfo
The table here shows the details of a subscribed event.
Table A-79 SubscriptionInfo Object Description

eventTypes Req. Array[Number] Event type code, which is a decimal
integer, refer to Event Types or Alarm
eventDest Req. String Address to receive event information,
characters. The address adopts
RESTful callback mode, and supports
HTTP and HTTPS, its format is "http://
ip:port/eventRcv" or "https://ip:port/
eventRcv".
Note
Refer to Event Message Format for
the event details received in the
address.
passBack Req. Number Whether to enable event callback: 0-

no (by default), 1-yes.
454
A.1.80 tableInfo
The table here shows the table information.
Table A-80 tableInfo Object Description

tableList Req. Array Table list.
id Req. Number Table ID.
dataList Req. Array Table content.
row Req. Number Row.
column Req. Number Column.
value Req. String table cell content.
playTime Req. Number Display duration of the table.
A.1.81 TimeSchedule
The table here shows the information of time schedule template.
Table A-81 TimeSchedule Object Description

indexCode Req. String Time schedule template ID, which
name Req. String Name of the time schedule template,
A.1.82 TimeZoneInfo
The table shows the time zone information.
455
Table A-82 TimeZoneInfo Object Description

bias Req. Number Time difference (unit: minute)
between the current time zone and
zero zone.
enableDST Req. Number Whether to enable DST.
daylightBias Opt. Number DST duration (unit: minute).
daylightDate Opt. String Start time of DST, which is
represented by "MM:ww:dd:HH:mm".
MM (month), ww (xx week of the
month): 1, 2, 3, 4, 5 (the last week of
the month); dd (xx day of the week): 0
(Sunday), 1, 2, 3, 4, 5; HH (hour), mm
(minute). The maximum length of this
field is 9.
standardDate Opt. String End time of DST, which is represented
by "MM:ww:dd:HH:mm". MM
(month), ww (xx week of the month):
1, 2, 3, 4, 5 (the last week of the
month); dd (xx day of the week): 0
(Sunday), 1, 2, 3, 4, 5; HH (hour), mm
(minute). The maximum length of this
field is 9.
A.1.83 TwoWayAudioUrlInfo
The table shows the information of two-way audio URL.
Table A-83 TwoWayAudioUrlInfo Object Description

to 128 characters.
456
A.1.84 VehicleGroupInfo
The table here shows the vehicle group information.
Table A-84 VehicleGroupInfo Object Description

vehicleGroupInde Opt. String Vehicle group ID, which consists of up
xCode to 64 characters.
vehicleGroupNam Opt. String Vehicle group name, which consists of
e up to 32 characters.
description Opt. String Description, which consists of up to
128 characters.
A.1.85 VehicleInfo
The table here shows the information of a vehicle.
Table A-85 VehicleInfo Object Description

vehicleId Opt. String Vehicle ID, which consists of up to 64
characters.
plateNo Opt. String License plate number of the vehicle,
personName Opt. String Vehicle owner name, which consists
personFamilyNa Opt. String Family name of the vehicle owner,
me which consists of 256 characters.
personGivenNam Opt. String Given name of the vehicle owner,
e which consists of 256 characters.
phoneNo Opt. String Contact number of vehicle owner,
vehicleColor Opt. Number Vehicle colors, i.e., 0-other color, 1-
white, 2-sliver, 3-grey, 4-black, 5-red,
6-dark blue, 7-blue, 8-yellow, 9-green,
10-brown, 11-pink, 12-purple, 13-dark
blue, 14-cyan.
457

vehicleGroupInde Opt. String Vehicle group ID, which consists of up
xcode to 64 characters.
effectiveDate Req. String Start time of validity, in ISO 8601
time zone", e.g., "2018-07-
26T15:00:00 + 08:00".
expiredDate Req. String End time of validity, in ISO 8601
time zone", e.g., "2018-07-
26T15:00:00 + 08:00".
A.1.86 Version
The table here shows the product version information.
Table A-86 Version Object Description

produceName Req. String Product name, which consists of up to
64 characters.
softVersion Req. String Software version No. of the product,
A.1.87 VideoInfo
This table shows the information of a video segment for playback.
Table A-87 VideoInfo Object Description

beginTime Req. String Start time of video segment, which is
in ISO 8601 standard time format:
yyyy-MM-dd'T'HH:mm:ss.SSSzzz, e.g.,
2018-07-26T15:00:00 + 08:00. And
458

characters.
endTime Req. String End time of video segment, which is
in ISO 8601 standard time format:
yyyy-MM-dd'T'HH:mm:ss.SSSzzz, e.g.,
2018-07-26T15:00:00 + 08:00. And
characters.
size Req. Number Video segment size, unit: byte. And
characters.
url Opt. String Streaming URL, which consists of up
to 128 characters.
authentication Opt. String Authentication information, which
can contain up to 1024 characters.
A.1.88 Visitor
The table here shows the visitor information.
Table A-88 Visitor Object Description

ID Opt. Number Visitor ID, the maximum length is 32
characters.
BaseInfo Opt. BaseInfo Visitor's basic information, the
A.1.89 VisitorappointInfo
The table here shows the information of a reservation record.
459
Table A-89 VisitorappointInfo Object Description

receptionistId Opt. String ID of the person to be visited, which
appointStartTime Req. String Expected time of arrival in ISO 8601
"yyyy-MM-ddTHH:mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The maximum
appointEndTime Req. String Expected time of leaving in ISO 8601
"yyyy-MM-ddTHH:mm:ss+current
time zone", e.g., "2018-07-
26T15:00:00 + 08:00". The maximum
length is 64 characters. If the visitor
has checked out, all permissions
unassigned.
visitReasonType Req. Number Visiting purpose type: 0-business, 1-
training, 2-visit, 3-meeting, 4-others.
visitReasonDetail Opt. String Visiting purpose, this parameters is
visitReasonType is 4. The maximum
receptionistName Opt. String Name of the person to be visited. The
receptionistFullPa Opt. String Organization path of the person to be
th visited. The maximum length is 128
characters.
appointStatus Opt. String Reservation status: 0-reservation
record has been added; 1-reservation
record has been invalid; 2-visitor has
arrived. The maximum length is 64
characters.
appointID Opt. String Reservation record ID. The maximum
460

appointCode Opt. String Reservation code. The maximum
visitorInfo Opt. Array List of visitor's information.
visitorInfo[0] Opt. Object A visitor information. See details in
VisitorInfo .
A.1.90 VisitorInfo
The table here shows visitor information.
Table A-90 VisitorInfo Object Description

characters.
visitorFamilyNam Req. String Visitor's family name, which consists
e of up to 256 characters, but cannot
*?"<>|
visitorGivenName Req. String Visitor's given name, which consists of
up to 256 characters, but cannot
*?"<>|
gender Req. Number Gender: 0-unknown gender, 1-male,
2-female.
email Opt. String Email address.
phoneNo Opt. String Phone number, which consists of up
to 20 characters.
plateNo Opt. String License plate number, which consists
of up to 16 characters, but cannot
*?"<>|
companyName Opt. String Name of the company that the visitor
is from, which cannot contain special
461

certificateType Opt. Number Certificate type: 111-ID card, 414-
passport, 335-driver's license.
certificateNo Opt. String Certificate number, which consists of
up to 20 characters. Certificate type is
required when certificate number
exists.
remark Opt. String Remark, which consists of up to 128
characters.
faces Opt. Array List of face information.
faces[0] Opt. Object Specific face information (Base64
picture data for adding face
information and picture URL for
getting face information).
fingerPrint Opt. Array List of finger print information.
fingerPrint[0] Opt. FingerPrint Specific finger print information.
cards Opt. Array List of card No.
cards[0] Opt. Card Specific card No.
identiPhoto Opt. Array List of visitor's ID photo.
identiPhoto[0] Opt. String Specific visitor's ID photo (Base64
picture data for adding photo and
picture URL for getting photo).
VisitorPhoto Opt. Array List of visitor's profile photo.
VisitorPhoto[0] Opt. VisitorPhoto Specific visitor's profile photo.
customField Opt. Array List of visitor custom information.
customField[0] Opt. CustomField Visitor custom information.
A.1.91 VisitorPhoto
The table here shows visitor's photo information.
462
Table A-91 VisitorPhoto Object Description

haveVisitorPhoto Opt. String Whether visitor's profile photo exists.
haveIdentiPhoto Opt. String Whether visitor's ID photo exists.
A.2 Event Message Format

The event message is in JSON format, and the encoding format is UTF-8.
Parameter Name Required/ Data Type Description

Optional
method Required String Method name for indicating the message use.
Here, it always be "OnEventNotify".
params Required Table 6-92 Event parameters.
Table A-92 Params

Optional
sendTime Required String Event sending time after processing by
program, which is in ISO 8601 standard time
format: YYYY-mm-dd hh:MM:ss + zone, e.g.,
2018-08-15T 15:53:47.000+08:00.
ability Required String Event category, such as video event (event_vss),
access control event (event_acs), ANPR event
(event_veh), and on-board monitoring event
(event_ms).
events Required Table 6-93 Event information.
463
Table A-93 Events

Optional
eventId Required String Event ID (UUID), if the same event occurred for
multiple times, the IDs are same. Its maximum
size is 64 bytes.
srcIndex Required String Event source ID. For physical devices, it is the
resource No. Its maximum size is 64 bytes.
srcType Required String Event source type code, or resource type code.
srcName Optional String Event source name, which is customized by
application. The name is in UTF-8 encoding
format.
eventType Required Number Event types, refer to Event Types or Alarm
status Required Number Event status: 0-occurred, 1-started, 2-ended, 3-
event pulse, 4-event linkage updated, 5-event
picture uploaded.
eventLvl Optional Number Event level: 0-unconfigured (default), 1-low, 2-
medium, 3-high.
timeout Required Number Heartbeat timeout. Currently, this field is
reserved.
happenTime Required String Event occurred time (local time), which is in ISO
8601 standard time format, e.g., 2018-08-15T
15:53:47.000+08:00.
srcParentIdex Optional String Parent device No. of event source. If there is no
parent device, set it to "null". Its maximum size
is 64 bytes.
data Optional JSON Event extension information. Its maximum size
is 512 bytes. Refer to ANPR Event Message ,
License Plate Matched or Mismatched Event
Message , Access Control Event Message , and
Face Comparison Event Message for details.
Example
Event Message Example
{
"method": "OnEventNotify",
464
"params":{
"sendTime": "2017-07-01T15:34:01.000+08:00",
"ability":"event_vss",
"events":[{
"eventId":"c929d9f873eb48439bd2c59df358bbeb",
"srcIndex":"21000000001130001013",
"srcType":"camera",
"srcName":"optional_src_name",
"eventType":130001,
"status":1,
"timeout":30,
"happenTime":"2017-07-01T15:34:01.000+08:00",
"srcParentIdex":"optional-parent",
"data":{"extral event data info":""}
}]
}
}
A.2.1 Access Control Event Message

The table here shows the parameter fields of access control event message.

personId Req. String Person ID.
personCode Opt. String Person No.
cardNo Req. String Card No.
checkInAndOutTy Req. Number Attendance type, -1: unknown, 1:
pe check-in, 2: check-out, 3: break-out, 4:
break-in, 5: overtime-in, 6: overtime-
out.
picUri Opt. String Picture URL.
temperatureData Opt. Float Temperature value.
yes, 2-no.
readerIndexCode Opt. String Card reader ID.
readerName Opt. String Card reader name.
Example
Message Example of Access Control Event
465
{
"personId": "",
"cardNo": "",
"checkInAndOutType": ,
"picUri": "",
"temperatureData": ,
"temperatureStatus": ,
"wearMaskStatus": ,
"readerIndexCode": ,
"readerName":
}
A.2.2 ANPR Event Message

The table here shows the fields of ANPR event message.
Table A-94 Message Field Description

plateNo Req. String License plate number.
Example
Message Example of ANPR Event
{
"plateNo":""
}
A.2.3 License Plate Matched or Mismatched Event Message

The table here shows the fields of license plate matched or mismatched event message.

plateNo Req. String License plate number.
vehicleGroupInde Req. String Vehicle group ID.
xCode
Example
Message Example of License Plate Matched or Mismatched Event
{
"plateNo":"",
466
"vehicleGroupIndexCode":""
}
A.2.4 Face Comparison Event Message

The table here shows the parameter fields of face comparison event message.

alarmResult Req. Object Face picture comparison results.
faces Req. Array Face information list.
faces[0] Req. Object Information of a face in the list.
URL Req. String Captured face picture URL.
snap_pic_data Opt. String Captured face picture data, which is
encoded by Base64.
age Opt. Object Age information.
ageGroup Opt. String Age group: "UNKNOWN", "CHILD",
"YOUNG", "MIDDLE", "OLD",
"INFANT", "KID", "TEENAGER",
"PRIME", "MIDDLEAGED".
faceRect Opt. Array Coordinates information list of a face
frame.
faceRect[0] Opt. Object Coordinates information of a face
frame in the list.
height Opt. Number Height.
width Opt. Number Width.
x Opt. Number X-coordinate.
y Opt. Number Y-coordinate.
temperature Opt. Object Temperature information.
temperatureData Opt. Float Temperature value.
mask Opt. Object Wearing mask information.
467

yes, 2-no.
gender Opt. Object Gender information.
value Opt. String Gender: "0" (unknown), "1" (male),
"2" (female).
identify Opt. Object Identification information.
candidate Req. Object Matched face information.
blacklist_id Req. String Face comparison group ID of the
matched face.
human_data Req. Object Person data.
face_picurl Req. String Picture URL of the matched face.
face_pic_data Opt. String Picture data of the matched face,
which is encoded by Base64.
human_id Req. String Person ID of the matched face.
reserve_field Opt. Object Reserved field.
name Opt. String Person name of the face.
similarity Req. Number Similarity between the matched face
and captured face.
targetAttrs Req. Object Target attributes.
cameraIndexCode Req. String Camera ID of the captured picture.
faceTime Req. String Captured time.
dataType Req. String Event types, for face picture
comparison event, the value of this
field is "faceMatch".
Example
Message Example of Face Comparison Event
{
"alarmResult":{
"faces":[{
"URL": "",
"snap_pic_data": "",
"age":{
"ageGroup":"CHILD"
},
468
"faceRect":[{
"height": ,
"width": ,
"x": ,
"y":
}],
"temperature":{
"temperatureData": ,
"temperatureStatus":
},
"mask":{
"wearMaskStatus":
},
"gender":{
"value":"1",
},
"identify":{
"candidate":{
"blacklist_id": "",
"human_data":{
"face_picurl": "",
"face_pic_data": ""
},
"human_id":"",
"reserve_field":{
"name":""
},
"similarity":
}
}
}],
"targetAttrs":{
"cameraIndexCode":"",
"faceTime": ""
}
}
dataType:""
}
A.2.5 On-Board Monitoring Event Message

The table here shows the parameter fields of on-board monitoring event message.

gps Req. Object GPS information.
vehicle Req. Object Vehicle information.
urlList Opt. urlList[] URL of picutures or short videos.
469
Table A-97 gps field description

occurTime Req. String GPS report time, in ISO 8601 standard
time format: yyyy-MM-ddTHH:mm:ss
26T15:00:00+08:00.
longitude Req. Float Longitude.
latitude Req. Float Latitude.
* 100; [0, 36000)).
speedUnit Req. Number Speed unit: 0-km/h, 1-Mph.
displayInfo Req. String Displayed GPS information.
directionInfo Req. String Displayed direction ("North",
16 characters.
Table A-98 vehicle field description

plateNo Req. String License plate number of the vehicle,
ownerName Req. String Vehicle owner name, which is the
specific field of the event message.
phoneNo Req. String Vehicle owner's contact number.
vehicleBrand Req. Number Vehicle brand.
vehicleColor Req. Number Vehicle color.
vehicleType Req. String Vehicle type: 0-others, 1-small-sized
motorcycle.
470
Table A-99 urlList field description

format Req. String Format: 0-URL format, 1-binary
format.
url Req. String URL of pictures or short videos, which
is the specific field of the event
message.
expandInfo Opt. String Extension information.
Table A-100 expandInfo field description

suffixName Req. String File extension, e.g., "jpeg".
mediaType Req. String Media type: VideoClip- video files,
Image-pictures (default).
Example
Message Example of On-Board Monitoring Event
{
"urlList": [
{
"format": 0,
"url": "Vsm://PHQG#20220622#20220622_112325847.d:1941072:537216",
"expand": {
"suffixName": "jpeg",
"mediaType": "Image"
}
}
],
"gps": {
"occurTime": "2022-06-22T16:48:06+08:00",
"longitude": 120.21746826171875,
"latitude": 30.210418701171876,
"direction": 12000,
"speed": 0.0,
"speedUnit": 0,
"displayInfo": "E120,13,2;N30,12,37",
"directionInfo": "North"
},
"vehicle": {
"ownerName": "",
"phoneNo": "",
"vehicleBrand": 0,
471
"vehicleColor": 0,
"vehicleTpe": 0
}
}
A.3 Data Dictionary
Resource Types / Resource Permission Code
Resource Code Resource Name Permission Permission Control Name

Control Code
region Area. view View.
acsDevice Access controller. view View.
eventRecv Receive events.
door Access point. view View.
doorControl Open/Close door.
normalControl Remain open/closed door.
encodeDevice Encoding device. view View.
intercom Device intercom.
mobileDevice On-board device. \ \
mobileVehicle Vehicle linked to \ \
on-board device.
camera Camera. view View.
preview Preview.
ptzControl PTZ control.
audioRecv Receive audio.
playback Playback recording.
osdConfig OSD overlay configuration.
picQuery Search picture.
472
Resource Code Resource Name Permission Permission Control Name

Control Code
histroyWay Playback pattern.
ioIn Alarm input. view View.
ioOut Alarm output. view View.
ioOutControl Output Control.
generalEventRule General event view View.
rule.
Access Protocol of Device
Access Protocol Code Access Protocol Name

hiksdk_net Hikvision Private Protocol
ehome_reg Hikvision Intelligent Security Uplink Protocol
onvif_net ONVIF Protocol
Gender Type
Gender Type Type Description

0 Unknown.
1 Male.
2 Female.
Vehicle Color
Color Type Type Description

0 Other color.
1 White.
2 Silver.
3 Gray.
473
Color Type Type Description

4 Black.
5 Red.
6 Dark Blue.
7 Blue.
8 Yellow.
9 Green.
10 Brown.
11 Pink.
12 Purple.
13 Dark Gray.
14 Cyan.
Video Type
Enumeration Data Type Enumeration Enumeration Enumeration Value

Field Type Value Description
streamType Number Stream Type 0 Main Stream.
1 Sub Stream.
protocol String Stream Protocol rtsp RTSP protocol.
rtmp RTMP protocol.
hls HLS protocol.
websocket Websocket protocol
streaming (added in
HikCentral and applied in
jsdecoder).
rtsp_s Standard protocol
streaming (added in
HikCentral and applied in
RTSP streaming).
websocket_s WebSocket Secure
protocol streaming.
474
Enumeration Data Type Enumeration Enumeration Enumeration Value

Field Type Value Description
transmode Number Transmission 0 UDP.
Protocol
1 TCP.
recordLocation String Storage Type 0 Center Storage.
1 Device Storage.
action Number PTZ Control 0 Start.
1 Stop.
command String Control LEFT Turn left.
Command
RIGHT Turn right.
UP Turn up.
DOWN Turn down.
ZOOM_IN Zoom in.
ZOOM_OUT Zoom out.
LEFT_UP Turn upper left.
LEFT_DOWN Turn lower left.
RIGHT_UP Turn upper right.
RIGHT_ Turn lower right.
DOWN
FOCUS_NEAR Focus+.
FOCUS_FAR Focus-.
IRIS_ Iris+.
ENLARGE
IRIS_REDUCE Iris-.
GOTO_ Go to preset.
PRESET
475
Capability Set
Capability Set ID Capability Set Name

vss Video capability.
event_veh Vehice capture capability.
gis FoV capability.
event_heat Thermal imaging capability.
event_pdc People counting statistics capability.
ptz PTZ capability.
Recording Storage Location
Recording Storage Type Code Recording Storage Type

0 Center storage.
1 Device Storage.
2 Center cluster storage.
Transmission Protocol
Transmission Protocol Code Transmission Protocol Name

0 UDP
1 TCP
Recording Type
Recording Type Code

0 Main storage.
1 Main storage.
476
Age Group
Age Group Code Age Group Name Remarks

UNKNOWN Unknown. 0
CHILD Teenager. 3
YOUNG Youth. 5
MIDDLE Middle age. 7
OLD Elderly. 9
INFANT Infant. 1
KID Child. 2
TEENAGER Early youth. 4
PRIME Prime. 6
MIDDLEAGED Middle to old age. 8
A.4 Event Types or Alarm Categories
Camera Alarms
Alarm Category Category Code Resource Type

Vehicle Matched Event 130 camera
Vehicle Mismatched Event 131 camera
Temperature Exception 193 camera
No Mask 194 camera
Face Capture 49697 camera
Driving on the Lane Line 103008 camera
Video Loss 131329 camera
Video Tampering Detection 131330 camera
Motion Detection 131331 camera
Line Crossing 131585 camera
Region Entrance 131586 camera
477

Region Exiting 131587 camera
Intrusion 131588 camera
Loitering 131590 camera
Parking 131591 camera
Fast Moving 131592 camera
People Gathering Alarm 131593 camera
Unattended Baggage 131594 camera
Object Removal 131595 camera
Violent Motion Detection 131596 camera
Climbing Detection 131597 camera
Getting Up Detection 131598 camera
Operation Timeout 131600 camera
Sticking Script 131601 camera
Install Card Reader 131602 camera
Absence Detection 131603 camera
Tailing 131604 camera
Falling Down 131605 camera
In-Toilet Overtime Detection 131608 camera
Yard Overstay Detection 131609 camera
Key Person Getting Up Detection 131610 camera
Scene Change Detection 131612 camera
Defocus Detection 131613 camera
Audio Exception Detection 131623 camera
Abnormal Number of People 131664 camera
Standing Up Detection 131666 camera
Sitting Detection 131667 camera
Staying Overtime 131669 camera
People Density Analysis 131672 camera
478

Using Mobile Phone 131673 camera
Physical Conflict 131677 camera
Physical Conflict (Indoor) 131678 camera
Wrong-Way Driving 131679 camera
Police Absence 131682 camera
People Density 131702 camera
Abnormal Face 131704 camera
Sleep on Duty Detection 131717 camera
Vehicle Speeding 131841 camera
Making Phone Call 132374 camera
Waiting Time Detection Alarm 133121 camera
People Queuing-up Alarm 133122 camera
Fire and Smoke Detection 192515 camera
Temperature Alarm 192517 camera
Temperature Difference Alarm 192518 camera
Reverse Entering Alarm 200497 camera
Illegal Lane Change 225309 camera
Illegal Parking 254101 camera
PIR 364545 camera
Camera Recording Exception 385052 camera
Camera Recording Recovered 385053 camera
Hard Hat Detection 1417219 camera
Multi-Target-Type Detection 1421313 camera
Sudden Change of Sound Intensity Detection 1441795 camera
Intrusion Detection 1482753 camera
AIOP Event 3072-4071 camera
HEOP Event 4027 camera
479
Alarm Input Alarms

Alarm Input Triggered 589825 ioIn
Encoding Device Alarms

HDD Full 66050 encodeDevice
Illegal Login 66053 encodeDevice
R/W HDD Failure 66054 encodeDevice
Array Exception 66055 encodeDevice
Video Standard Mismatch 66065 encodeDevice
Camera/Recording Resolution Mismatch 66066 encodeDevice
Device Offline 66306 encodeDevice
Device Reconnected 66311 encodeDevice
Encoding Device Recording Exception 385050 encodeDevice
Encoding Device Recording Recovered 385051 encodeDevice
HDD Bad Sector 225404 encodeDevice
HDD High Temperature 225405 encodeDevice
HDD Impact Detection 225406 encodeDevice
HDD Severe Failure 225407 encodeDevice
Door Alarms

Remaining Locked Status Started 198148 door
Remaining Locked Status Ended 198150 door
Door Open Timed Out (Door Contact) 198400 door
Remaining Unlocked Status Started 198401 door
Remaining Unlocked Status Ended 198402 door
480

Force Accessing 198657 door
Door Abnormally Open (Door Contact) 198658 door
Door Open (Door Contact) 198913 door
Remote: Unlocked Door 198919 door
Remote: Remained Unlocked (Free Access) 198922 door
Door Closed (Door Contact) 199169 door
Remote: Locked Door 199171 door
Remote: Remained Locked (Credential Failed) 199172 door
Card Reader Tampering Alarm 199608 door
Door Unlocked (Door Lock) 199941 door
Door Locked (Door Lock) 199942 door
Access Control Device Alarms

Device Tampered 199708 acsDevice
Device Tampering Alarm Restored 199709 acsDevice
On-Board Device Alarms

Vehicle Resource Linked to On- 641 mobileDevice
Board Devices Online
Vehicle Resources Linked to 642 mobileDevice
On-Board Devices Offline
Person Alarms

Temperature Exception 193 camera/door
No Mask 194 camera/door
481
General Event Alarms
Event Type Event Type Code Resource Type

Generic Event 195 generalEventRule
Card Swiping Events

Multi-Factor Authentication: Access 196883 door
Granted
Multi-Factor Authentication: Super 196884 door
Password Access Granted
Access Granted by Card and Fingerprint 196885 door
Access Granted by Card, Fingerprint, and 196886 door
PIN
Access Granted by Fingerprint and PIN 196887 door
Access Granted by Face and Fingerprint 196888 door
Access Granted by Face and PIN 196889 door
Access Granted by Face and Card 196890 door
Access Granted by Face, PIN, and 196891 door
Fingerprint
Access Granted by Face, Card, and 196892 door
Fingerprint
Access Granted by Face 196893 door
Access Granted by Employee ID and 196894 door
Fingerprint
Access Granted by Employee ID, 196895 door
Fingerprint, and PIN
Access Granted by Employee ID and Face 196896 door
Access Granted by Employee ID and PIN 196897 door
Access Denied by Invalid MIFARE Card 196898 door
Verifying CPU Card Encryption Failed 196899 door
482

Access Denied (NFC Card Reading 196900 door
Disabled)
EM Card Reading Not Enabled 196901 door
M1 Card Reading Not Enabled 196902 door
CPU Card Reading Disabled 196903 door
Skin-Surface Temperature Measured 197107 door
Access Granted by Fingerprint 197127 door
Access Denied by Fingerprint 197128 door
Access Timed Out by Card and PIN 197132 door
Max. Card and Password Authentication 197133 door
Times
Access Denied by Card and Fingerprint 197134 door
Access Timed Out by Card and Fingerprint 197135 door
Access Denied by Card, Fingerprint, and 197136 door
PIN
Access Timed Out by Card, Fingerprint, 197137 door
and PIN
Access Denied by Fingerprint and PIN 197138 door
Access Timed Out by Fingerprint and PIN 197139 door
Fingerprint Does Not Exist 197140 door
Access Denied by Face and Fingerprint 197141 door
Access Timed Out by Face and Fingerprint 197142 door
Access Denied by Face and PIN 197143 door
Access Timed Out by Face and PIN 197144 door
Access Denied by Face and Card 197145 door
Access Timed Out by Face and Card 197146 door
Access Denied by Face, PIN, and 197147 door
Fingerprint
Access Timed Out by Face, PIN, and 197148 door
Fingerprint
483

Access Denied by Face, Card, and 197149 door
Fingerprint
Access Timed Out by Face, Card, and 197150 door
Fingerprint
Access Denied by Face 197151 door
Access Denied by Employee ID and 197152 door
Fingerprint
Access Timed Out by Employee ID and 197153 door
Fingerprint
Access Denied by Employee ID, 197154 door
Access Timed Out by Employee ID, 197155 door
Access Denied by Employee ID and Face 197156 door
Access Timed Out by Employee ID and 197157 door
Face
Access Denied by Employee ID and PIN 197158 door
Access Timed Out by Employee ID and PIN 197159 door
Facial Recognition Failed 197160 door
Live Facial Detection Failed 197161 door
Access Denied by Card and PIN 197382 door
Anti-Passback Violation 197383 door
Invalid Time Period 197384 door
Card Not in Multi-Factor Authentication 197391 door
Group
Card Not in Multi-Factor Authentication 197392 door
Duration
Card No. Expired 197633 door
Card No. Does Not Exist 197634 door
No Access Level Assigned 197635 door
Multi-Door Interlocking 198146 door
484

Access Granted by Card 198914 door
Access Granted by Card and PIN 198915 door
Max. Card Access Failed Attempts 199429 door
Access Denied: First Person Not 200477 door
Authorized
Access Denied (Door Remained Locked or 200513 door
Inactive)
Access Denied: Scheduled Sleep Mode 200514 door
Employee ID Does Not Exist 200515 door
Access Granted via Combined 200516 door
Authentication Modes
Combined Authentication Timed Out 200517 door
Authentication Mode Mismatch 200518 door
Password Mismatches 200519 door
Verifying Card Encryption Information 261952 door
Failed
Password Authenticated 263433 door
Duress Alarm 721678 door
Failed Password Attempts Alarm 983304 door
ANPR Events

License Plate Information Uploading 131622 camera
Facial Events

Face Picture Comparison Event 131659 camera
485
Events of Vehicles Linked to On-Board Devices

GPS Data Report 643 mobileVehicle
Forward Collision Warning 644 mobileVehicle
Headway Monitoring Warning 645 mobileVehicle
Lane Deviation Warning 646 mobileVehicle
Pedestrian Collision Warning 647 mobileVehicle
Speed Limit Warning 648 mobileVehicle
Blind Spot Warning 649 mobileVehicle
Smoking 650 mobileVehicle
Using Mobile Phone 651 mobileVehicle
Fatigue Driving 652 mobileVehicle
Distraction 653 mobileVehicle
Seatbelt Unbuckled 654 mobileVehicle
Video Tampering 655 mobileVehicle
Emergency Alarm 656 mobileVehicle
Sharp Turn 657 mobileVehicle
Sudden Brake 658 mobileVehicle
Sudden Acceleration 659 mobileVehicle
Rollover 660 mobileVehicle
Speeding 661 mobileVehicle
Collision 662 mobileVehicle
Fence for Entry Detection 663 mobileVehicle
Deviation 664 mobileVehicle
Fence for Exit Detection 665 mobileVehicle
A.5 Status or Error Code
486
API Gateway Status or Error
Status or Error Code Description

0x02401000 No AppKey is configured. Enter the correct AppKey in the
request.
0x02401001 The partner of AppKey does not exist. Check the AppKey in the
request.
0x02401002 No signature is configured. Enter the correct signature in the
request.
0x02401003 Invalid signature. Check the signature in the request.
0x02401004 Token authentication failed. Check the token.
0x02401005 No token is configured. Enter the token.
0x02401006 Token exception. Check the token.
0x02401007 No permission. Please contact the administrator to apply for
permissions.
0x02401008 Authentication exception. Check the gateway service.
0x02401009 Maximum API calling attempts reached. Please contact the
administrator to apply for adding access attempts.
0x0240100a Parameter conversion exception. Check the API parameters.
0x0240100b Calling statistics exception. Check the gateway.
Parameter Status or Error

0x00072001 The required parameters are not configured. Set the required
parameters in the request.
0x00072002 Invalid parameter value range.
0x00072003 Invalid parameter value format.
0x00072004 The response message is too long. Set the page size in the
request.
487
Internal Service Status or Error

0x00052101 Highest service performance reached. Try again later.
0x00052102 Service error. Try again later.
0x00052103 Service response timed out. Try again later.
0x00052104 Service is not available. Try again after restoring the service.
Resource Access Status or Error

0x00072201 No permission for resource access. Please contact the
administrator to apply for permissions.
0x00072202 The resource does not exist. Enter the correct resource No. in
the request.
0x00072203 Maximum number of Licenses reached. Check the License
information from the administrator.
0x00072204 No permission for this function. Check the License information
from the administrator.
Other Status or Error

0x00052301 Unknown error.
OpenAPI Translation Service Status or Error

1 Unknown error.
2 Incorrect request parameter.
3 Insufficient system resources.
4 Network timed out.
5 Service exception.
488

6 The server is busy.
7 Invalid network command.
8 This product version is not supported.
9 Invalid token.
10 Incorrect XML response message.
11 The HTTP is not supported.
12 The URL is not supported.
13 The authentication information between service and HikCentral
Professional OpenAPI mismatches.
14 The WAN information of HikCentral Professional OpenAPI is not
configured.
15 The NIC information of HikCentral Professional OpenAPI is not
configured.
16 Connecting to service exception.
17 No permission for OpenAPI access.
64 The user of third-party partner platform exception.
65 The user is locked.
66 The user does not exist.
67 Initialize before login for first time.
128 The request resource does not exist.
129 The resource is offline.
130 No permission for the resource access.
131 The request resource already exists.
132 The maximum number of resources reached.
133 The resource is occupied.
140 The recording schedule does not exist.
192 Operation and control failed.
193 Connecting to cloud storage failed.
489

194 Connecting to device failed.
195 The device does not support this function.
490
UD32209B

HikCentral Professional OpenAPI - Developer Guide - V2.4

Uploaded by

Copyright:

Available Formats

HikCentral Professional OpenAPI - Developer Guide - V2.4

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

HikCentral Professional OpenAPI - Developer Guide - V2.4

Uploaded by

Copyright:

Available Formats

4.1 Manage Resources ............................................................................................................... 35

5.2.10 POST /artemis/api/resource/v1/mobileDevice/advance/mobileDeviceList ............. 86

5.4.10 POST /artemis/api/video/v1/patrols/addition ........................................................ 249

5.6.3 POST /artemis/api/visitor/v1/registerment .............................................................. 298

5.7.14 POST /artemis/api/vehicle/v1/vehicle/blocklist/delete .......................................... 358

A.1.1 AccessLevel ............................................................................................................... 403

A.1.29 FaceGroupInfo ........................................................................................................ 421

A.1.57 PeopleCountInfo ..................................................................................................... 441

A.1.85 VehicleInfo .............................................................................................................. 457

1.2 System Requirements

1.3 Open Capabilities

Figure 1-1 Open Capabilities Directory

1.3.1 Resource Capability

Figure 1-2 Resource Capability Directory

1.3.2 Video Capability

Figure 1-3 Video Capability Directory

1.3.3 Event and Alarm Capability

Figure 1-4 Event and Alarm Capability Directory

1.3.4 Vehicle and Parking Management Capability

Figure 1-5 Vehicle and Parking Management Capability Directory

1.3.5 Access Control Capability

Figure 1-6 Directory of Access Control Capability Directory

1.3.6 Visitor Management Capability

Figure 1-7 Visitor Management Capability Directory

1.3.7 On-Board Monitoring Capability

Figure 1-8 On-Board Monitoring Capability Directory

1.3.8 Digital Signage Capability

Figure 1-9 Digital Signage Capability Directory

1.4 Terms and Definitions

1.5 Update History

Summary of Changes in Version 2.4_Jan., 2023

6. Access control APIs:

Summary of Changes in Version 2.3.1_Oct., 2022

Extended the response message for checking in a visitor ( POST /artemis/api/visitor/v1/

Summary of Changes in Version 2.2.1_Mar., 2022

Summary of Changes in Version 2.2.0_Nov., 2021

added a parameter accessInfo (visitor's access permission).

Summary of Changes in Version 2.1.0_May, 2021

added a parameter eventLvl (event level).

Summary of Changes in Version 2.0.0_Sept., 2020

Summary of Changes in Version 1.7.0_May, 2020

6. Added an API to get people counting statistics of a camera: POST /artemis/api/

added a parameter "relatedCardNo" (the linked card No.).

Summary of Changes in Version 1.6.0_Dec., 2019

Summary of Changes in Version 1.5.1_Oct., 2019

Summary of Changes in Version 1.5.0_Sept., 2019

Chapter 2 Getting Started

Figure 2-1 Enable License of Third-Party Integration

Folder Name File Description

Folder Name File Description

2.2.1 Authenticate Service Certificate

Figure 2-2 View Service Certificate

2.2.2 Enable Open Platform

Figure 2-3 Enable Open Platform Page

2.3 Run Open Platform

Figure 2-4 Open Platform Login Page

Figure 2-5 Create Partner Page