1.6. 自助安检第二道门开门请求¶

1.6.1. 场景描述¶

旅客通过自助安检闸机第一道门后，闸机对旅客拍照进行人脸比对，将比对结果发送至安检信息系统，安检信息系统判断比对结果并反馈闸机第二道门下一步的动作。

1.6.1.1. 面向客户端¶

闸机

1.6.2. 请求URL¶

HTTP POST /api/selfsecurity/facerecognition

1.6.3. 请求体格式¶

请求体格式为JSON，字段名不区分大小写:

{
    "deviceCode":"string",//设备编号
    "similarity":"double",//人脸识别相似度,对于超时未捕捉到画面的情形,该项传-1,Photo传空字符串
    "facePhoto":"string",//拍摄人脸照片(含背景)Base64编码
    "faceConstractPhoto":"string",//人脸识别图像(仅人脸)Base64编码
    "lastResponseId":"long"//第一道门请求响应的流水号
}

1.6.4. 请求体示例¶

{
    "deviceCode":"Z001",
    "similarity":0.98,
    "facePhoto":"LKHKKJGJHGBHKJDSH42153544FDJAFOIJOIA123……",
    "faceConstractPhoto":"ABSSDDADFDSFDSH42153544FDJAFOIJOIA123……",
    "lastResponseId":7809242345
}

1.6.5. 响应体格式¶

{
    "responseId":"long",//响应流水号,用于闸机动作后反馈状态时提供
    "gateAction":"int",//闸机动作,附说明
    "statusCode":"int",//状态码,附说明
    "description":"string",//状态描述
    "type":"string",//证件类型
    "id":"string",//证件号
    "name":"string",//姓名
    "flightDate":"string",//航班日期
    "flightNo":"string",//航班号
    "departure":"string",//始发站
    "destination":"string",//目的站
    "seatNo":"string",//座位号
    "boardNo":"string",//登机号
    "flightStatus":"string", //航班状态,ONR:前站起飞;ARR:本站到达;CKI:值机开始;CKO:值机截止;BOR:登机开始;TBR:过站登机;LBD:催促登机;POK:登机截止;DEP:起飞;DLY:延误;CAN:取消;RTN:返航;ALT:备降
    "lockType":"int", //锁定类型,指示闸机锁人后, 返回锁定的类型, 0:无锁定; 1:人脸比对失败; 2:布控人员
    "wait":"int" //等待秒数，用于流量控制时，下一位旅客的等待倒计时，仅在安检一门的请求响应值中有效，且倒计时从接收到响应值时开始计时，在其他的请求响应值中为无效值 0
}

1.6.5.1. gateAction闸机动作说明¶

gateAction	说明
0	关闭
1	开启
2	关闭且报警
3	一门开启后锁定
6	二门重试
11	反向开门

1.6.5.2. statusCode状态码说明¶

statusCode	说明
200	正常通行
201	催促登机
202	重复安检
400	证件失效
401	始发站有误
402	航班日期有误
403	值机删除
404	尚未值机
405	携带婴儿
406	区域有误
409	闸机设备未识别
410	航班未找到
411	航班延误
412	航班取消
413	航班起飞
414	登机截止
415	多张机票
421	布控航班
422	布控人员
423	黑名单
430	人脸比对失败
431	人脸比对失败次数超过上限
440	目的站未识别
441	参数错误

1.6.6. 响应体示例¶

{
    "responseId":7976321,
    "gateAction":0,
    "statusCode":413,
    "description":"航班CA1234起飞;Flight Takeoff",
    "type":"NI",
    "id":"110101197608056896",
    "name":"张三",
    "flightDate":"2018-10-10",
    "flightNo":"CA1234",
    "departure":"TAO",
    "destination":"CAN",
    "seatNo":"37A",
    "boardNo":"123",
    "flightStatus":"DEP",
    "lockType":0,
    "wait":10
}

1.6.6.1. 响应值说明¶

gateAction值说明

在安检闸机第二道门开门请求响应中，有效值为0,1,2,6
当gateAction为1时，闸机二门开门放行，旅客通过后，二门关闭，验证流程结束
当gateAction为6时，闸机二门不予放行，且重新发起人脸比对请求
当gateAction为0时，闸机二门不予放行，且不再发起人脸比对请求，进入锁定模式，并记录lockType的值作为锁定类型，用于心跳时上报
当gateAction为2时，闸机二门不予放行，且不再发起人脸比对请求，进入锁定模式，并记录lockType的值作为锁定类型，用于心跳时上报，同时播放报警音长鸣，报警音直到工作人员介入处理后结束