1.1. 预安检闸机开门请求¶
1.1.1. 场景描述¶
旅客通过预安检闸机时，扫描证件或登机牌，闸机将扫描到的证件信息和登机牌信息发送至安检信息系统，安检信息系统判断旅客信息并反馈闸机下一步的动作。
1.1.1.1. 面向客户端¶
闸机
1.1.2. 扫描证件信息请求URL¶
HTTP POST /api/presecurity/id
1.1.3. 扫描证件信息请求体格式¶
请求体格式为JSON，字段名不区分大小写:
{
"deviceCode":"string",//设备编号
"type":"string", //证件类型, 说明如下
"id":"string",//证件号
"name":"string",//姓名,身份证姓名,中文姓名
"engName":"string",//英文名
"validFromDate":"string",//发证日期
"validToDate":"string",//有效日期
"authority":"string",//发证机关
"address":"string",//住址
"birthday":"string",//出生日期
"nation":"string",//国籍/民族,护照对应国籍;身份证对应民族
"gender":"string",//性别,M:男;F:女;P:不区分性别
"photo":"string"//头像Base64编码
}
1.1.3.1. type 证件类型说明¶
| type | 说明 |
|---|---|
| NI | 中国居民身份证 |
| PP | 护照（芯片） |
| PPOCR | 护照（OCR模式识别） |
| TP | 港澳通行证（芯片） |
| TPOCR | 港澳通行证（OCR模式识别） |
| TW | 台湾通行证（芯片） |
| TWOCR | 台湾通行证（OCR模式识别） |
| HM | 港澳居民来往内地通行证（芯片） |
| HMOCR | 港澳居民来往内地通行证（OCR模式识别） |
| TB | 台湾居民来往大陆通行证（芯片） |
| TBOCR | 台湾居民来往大陆通行证（OCR模式识别） |
| HMT | 港澳台居民居住证 |
| FR | 外国人永久居留身份证 |
| ID | 其他证件 |
1.1.4. 扫描证件信息请求体示例¶
{
"deviceCode":"Z001",
"type":"NI",
"id":"110101197608056896",
"name":"张亿",
"engName":"ZHANGYI",
"validFromDate":"2012-01-01",
"validToDate":"2020-01-01",
"authority":"北京市公安局海淀分局",
"address":"北京市海淀区门头沟95号",
"birthday":"1976-08-05",
"nation":"汉",
"gender":"M",
"photo":"ABSSDDADFDSFDSH42153544FDJAFOIJOIA123……"
}
1.1.5. 扫描登机牌信息请求URL¶
HTTP POST /api/presecurity/boardpass
1.1.6. 扫描登机牌信息请求体格式¶
请求体格式为JSON，字段名不区分大小写:
{
"deviceCode":"string",//设备编号
"boardPassNo":"string"//登机牌号码
}
1.1.7. 扫描登机牌信息请求体示例¶
{
"deviceCode":"Z001",
"boardPassNo":"M1SURNAME/FIRSTNM ABCDEF TAOAAANH 9999O181C99999999 35D>5184 7181B1A 09999999999992A 0 NH XB FQTVNUMBER25FQTV Y*30699999K09 XBAASSR"
}
1.1.8. 响应体格式¶
{
"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.1.8.1. gateAction闸机动作说明¶
| gateAction | 说明 |
|---|---|
| 0 | 关闭 |
| 1 | 开启 |
| 2 | 关闭且报警 |
| 3 | 一门开启后锁定 |
| 6 | 二门重试 |
| 11 | 反向开门 |
1.1.8.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.1.9. 响应体示例¶
{
"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.1.9.1. 响应值说明¶
- gateAction值说明
- 在安检闸机第二道门开门请求响应中，有效值为0,1
- 当gateAction为0时，闸机不予放行，并在一屏显示拦截原因
- 当gateAction为1时，闸机开门放行，旅客进入后，栅门自动关闭