1.5. 自助安检第一道门开门请求¶
1.5.2. 请求URL¶
HTTP POST /api/selfsecurity/id
1.5.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.5.3.1. type 证件类型说明¶
| type | 说明 |
|---|---|
| NI | 中国居民身份证 |
| PP | 护照（芯片） |
| PPOCR | 护照（OCR模式识别） |
| TP | 港澳通行证（芯片） |
| TPOCR | 港澳通行证（OCR模式识别） |
| TW | 台湾通行证（芯片） |
| TWOCR | 台湾通行证（OCR模式识别） |
| HM | 港澳居民来往内地通行证（芯片） |
| HMOCR | 港澳居民来往内地通行证（OCR模式识别） |
| TB | 台湾居民来往大陆通行证（芯片） |
| TBOCR | 台湾居民来往大陆通行证（OCR模式识别） |
| HMT | 港澳台居民居住证 |
| FR | 外国人永久居留身份证 |
| ID | 其他证件 |
1.5.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.5.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.5.5.1. gateAction闸机动作说明¶
| gateAction | 说明 |
|---|---|
| 0 | 关闭 |
| 1 | 开启 |
| 2 | 关闭且报警 |
| 3 | 一门开启后锁定 |
| 6 | 二门重试 |
| 11 | 反向开门 |
1.5.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.5.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.5.6.1. 响应值说明¶
- gateAction值说明
- 在安检闸机第一道门开门请求响应中，有效值为0,1,3
- 当gateAction为0时，闸机一门不予放行，并在一屏显示拦截原因
- 当gateAction为1时，闸机一门开门放行，旅客进入后，一门关闭，开启人脸比对，并进行二门请求
- 当gateAction为3时，闸机一门开门放行，旅客进入后，一门关闭，但不再进行人脸比对和二门请求，进入锁定模式，并记录lockType的值作为锁定类型，用于心跳时上报
- wait值说明
- 仅在安检闸机第一道门开门响应中，该值有效，在其他的请求响应值中，为无效值 0
- 闸机程序在收到第一道门开门响应后，开始倒计时，如wait=10，则倒计时10秒
- 旅客进入一门，开始人脸比对，比对成功，正常通过二门，二门关闭，此过程倒计时不停止，若此过程耗时6秒，则倒计时剩余4秒
- 此时一屏显示倒计时画面，提示后续旅客等待，从4秒钟开始倒计时，每秒刷新画面
- 到倒计时为0时，一屏切换至欢迎页，后续旅客方可继续刷证过检
- 若旅客在二门处的验证时间超过10秒，即当该旅客验证完毕后，倒计时剩余0秒，则后续旅客无需等待，一屏直接切换至欢迎页