一、 場景描述
iSC
平臺的門禁產(chǎn)品及功能在項目應用廣泛，第三方對接門禁權限功能的需求也越來也
多，由于門禁權限下發(fā)需要涉及到往設備上下發(fā)，第三方接口調(diào)用一旦不正確，不合理的接
口調(diào)用很容易給我們平臺造成額外的性能消耗，甚至導致我們平臺掛掉，特此梳理下門禁權
限調(diào)用流程供大家參考。
二、 流程簡介
以
1.3.0
的
api
接口為例，我們提供了四種應用場景的
api
接口：
1
、 給單個人員下發(fā)單個門禁權限的應用場景；
2
、 指定人員集和門禁設備集異步下發(fā)權限的場景；
3
、 根據(jù)權限配置指定門禁設備集異步快捷下發(fā)的場景；
4
、 根據(jù)權限配置，通過創(chuàng)建下載任務的方式異步下發(fā)大批量的場景。
三、 接口調(diào)用流程
1.
單個人員下發(fā)單個門禁
簡單同步權限下載
_
根據(jù)人員與設備通道指定下載：
這種是最簡單的一種權限下發(fā)場景，一次只下發(fā)一個人員到一個門禁設備的場景，該接
口為同步下發(fā)接口，接口直接返回下發(fā)結果，大批量權限下發(fā)的時候不建議用頻繁調(diào)用該接
口的方式下發(fā)。接口說明如下：
?文章來源地址http://www.zghlxwxcb.cn/news/detail-781855.html
入?yún)⒅?
resourceInfo(
資源設備對象信息
)
需要傳入的是門禁設備信息：
resourceIndexCode(
資源的唯一標識
)
對應的是門禁設備編號；
resourceType(
資源類型
)
傳
acsDevice(
對應門禁設備的資源類型
)
；
channelNos(
資源通道號
)
是門禁點對應的門禁設備的通道號
這三個信息可以通過
查詢門禁點列表接口
獲取到，對應關系如下：
資源設備對象信息
門禁點信息
| ?
資源設備對象信息
|
門禁點信息
|
|
resourceIndexCode(
資源的唯一標識
)
|
acsDevIndexCode(
所屬門禁設備唯一標識
)
|
|
channelNos(
資源通道號
)
|
channelNo(
通道號
)
|
注意：當人員是系統(tǒng)內(nèi)人員
(
即平臺上的人員
)
的時候，人員信息中的卡片信息和人臉信息不需要傳入，默認
從人員基礎信息中獲取并下發(fā)；當人員是系統(tǒng)外人員時，卡片信息和人臉信息需要手動傳入
(
針對該部分人
員的，門禁事件上報到平臺的是匹配不到人員基礎信息
)
。
2.
指定人員集和門禁設備集異步下發(fā)
這種場景是通過創(chuàng)建下載任務
(
類似事務的模式
)
，在下載任務中指定人員集的門禁設備
集權限，然后開始執(zhí)行下載任務，我們服務端異步執(zhí)行異動下發(fā)的場景，接口調(diào)用流程如下：
2.1 創(chuàng)建下載任務_根據(jù)人員與設備通道指定下載
?文章來源：http://www.zghlxwxcb.cn/news/detail-781855.html
該接口用來創(chuàng)建要下載的任務類型，接口說明如下：
?
入?yún)⒅械?
taskType
用來指定創(chuàng)建的下載任務類型，
taskType
的枚舉值為
?
?
2.2
下載任務中添加數(shù)據(jù)_根據(jù)人員與設備通道指定下載
任務創(chuàng)建成功后，在任務中通過指定人員集和門禁設備集，來實現(xiàn)人員的門禁權限的配
置，接口說明如下：
?
?
其中的
resourceInfos(
資源對象
)
和
personInfos(
人員信息
)
，使用方式及數(shù)據(jù)來源和“簡單同步權限下載
_
根據(jù)人員與設備通道指定下載”接口相同。
2.3
開始下載任務
開始下載任務，將上一步任務中添加的人員對應門禁權限配置開始往門禁設備上下發(fā)，
接口說明如下
?
入?yún)⒅械?
taskId
同前兩步中的下載任務唯一標識。
該接口調(diào)用后，就把下載任務提交給我們平臺，接口返回結果
(
表示我們平臺已經(jīng)收到
下載任務
)
，我們平臺開始異步下發(fā)權限，下發(fā)進度及下發(fā)詳情等信息需要再異步調(diào)用后續(xù)
接口查詢。
2.4
查詢下載任務進度
通過下載任務唯一標識(taskId)查詢權限異步下載進度，接口說明如下：
?
2.5
查詢設備通道的人員權限下載詳情
通過
“
記錄唯一
ID”
或者
“
下載任務標識
+
設備通道對象
”
查詢權限下載詳情，查看具體每
條下載記錄的結果，接口說明如下
?
3.
根據(jù)權限配置指定門禁設備集異步快捷下發(fā)
這種場景是通過先配置人員門禁權限，然后指定門禁設備異步快捷下發(fā)的場景，適用于
少量權限（
100
設備通道
*1000
人）的下載，接口調(diào)用流程如下：
3.1
添加權限配置
通過指定人員數(shù)據(jù)列表和設備通道對象列表分配人員的門禁權限，對應平臺上的權限配
置，接口說明如下
?
3.2
根據(jù)出入權限配置快捷下載
針對上一步配置的人員門禁權限，通過指定門禁設備集實現(xiàn)對應門禁設備上的權限異動
下發(fā)，對應平臺上的指定設備異動下發(fā)權限，接口說明如下：
?
3.3
查詢下載任務進度及權限下載詳情
接口調(diào)用流程及說明同
2.4
、
2.5
，不再贅述。
4.
根據(jù)權限配置指定門禁設備集異步快捷下發(fā)
這種場景是通過先配置人員門禁權限，然后通過創(chuàng)建下載任務，在任務中添加需要下載
權限的設備集合，開始異步下載權限的場景，適用綜合大樓、學校、醫(yī)院等批量權限的下載，
接口調(diào)用流程如下：
4.1
添加權限配置
通過指定人員數(shù)據(jù)列表和設備通道對象列表分配人員的門禁權限，對應平臺上的權限配
置，接口說明如下
?
4.2
創(chuàng)建下載任務_根據(jù)出入權限配置下載
該接口用來創(chuàng)建根據(jù)設備通道下載的任務類型，接口說明如下：
?
4.3
添加待下載的設備通道_根據(jù)出入權限配置下載
把需要異步下發(fā)權限的門禁設備通道添加到下載任務中，接口說明如下：
?
4.4
開始下載任務、查詢下載進度及權限下載詳情
接口調(diào)用流程及說明同
2.3
、
2.4
、
2.5
，不再贅述。
四、 常見問題
以下列出幾種常見問題：
1.
接口添加的權限配置在平臺上看不到，在平臺上添加的權限接口里查不到
這個是因為接口中調(diào)用的是
acps
組件，平臺上用的是
acs
組件，截止
1.3.0
版本，
acps
和
acs
還沒有做通，所以，兩者之間相互查不到對應的權限配置及下載記錄等。
2.
通過接口下發(fā)人臉，返回下載數(shù)量為
0
常見原因包括以下幾種：
a)
對應的人員沒有下發(fā)卡權限，目前設備上還是以卡為中心的默認，下發(fā)人臉需要先下發(fā)
卡權限
(taskType=1)
，通常
taskType
傳
5
就是卡權限和人臉一起下發(fā)；
b)
接口在往非人臉設備上下發(fā)，人臉只支持下發(fā)到人臉設備，經(jīng)常會有第三方不對設備類
型進行區(qū)分，把人臉往門禁控制器上下發(fā)。
3.
人臉下發(fā)失敗
常見原因包括以下幾種：
a)
平臺上錄入的人臉照片質量不符合要求，這種情況接口中返回人臉下發(fā)失敗的原因；
b) Ehome
協(xié)議接入的門禁人臉設備，下發(fā)人臉的時候，
dac
是把人臉照片的圖片
url
下發(fā)
給設備，由設備主動從
asw
下載圖片，如果門禁設備在外網(wǎng)，
asw
的多線路沒有配置，
或者端口沒有映射，會導致門禁設備下載人臉失??；
c) Ehome
協(xié)議接入的門禁人臉設備，下發(fā)人臉還需要在
pstor
中配置
kms
資源池和
pss
資
源池。
4.
添加權限配置接口返回的 taskId 查詢進度無數(shù)據(jù)返回
添加權限配置接口是異步接口，也就是調(diào)用接口后，接口直接返回一個
taskId
，平臺內(nèi)
部在異步增加權限配置，接口返回的
taskId
是用來查詢權限配置進度，查詢權限配置進度的
接口基線還沒有對外開放，需要安裝資源包。
?
?
?
?
?
?
?
到了這里，關于海康威視iSC 平臺第三方對接門禁權限分享的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持TOY模板網(wǎng)！
