1.3. 预安检闸机旅客外出请求¶
1.3.1. 场景描述¶
旅客通过预安检区域后,因某些原因要外出预安检区,通过闸机反向扫描证件,闸机将扫描到的证件信息发送至安检信息系统,安检信息系统判断旅客信息并反馈闸机下一步的动作。
1.3.1.1. 面向客户端¶
闸机
1.3.2. 扫描证件信息请求URL¶
HTTP POST /api/presecurity/out
1.3.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.3.3.1. type 证件类型说明¶
| type | 说明 |
|---|---|
| NI | 中国居民身份证 |
| PP | 护照(芯片) |
| PPOCR | 护照(OCR模式识别) |
| TP | 港澳通行证(芯片) |
| TPOCR | 港澳通行证(OCR模式识别) |
| TW | 台湾通行证(芯片) |
| TWOCR | 台湾通行证(OCR模式识别) |
| HM | 港澳居民来往内地通行证(芯片) |
| HMOCR | 港澳居民来往内地通行证(OCR模式识别) |
| TB | 台湾居民来往大陆通行证(芯片) |
| TBOCR | 台湾居民来往大陆通行证(OCR模式识别) |
| HMT | 港澳台居民居住证 |
| FR | 外国人永久居留身份证 |
| ID | 其他证件 |
1.3.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.3.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",//登机号
}
1.3.5.1. gateAction闸机动作说明¶
| gateAction | 说明 |
|---|---|
| 0 | 关闭 |
| 11 | 反向开启 |
1.3.5.2. statusCode状态码说明¶
| statusCode | 说明 |
|---|---|
| 200 | 正常通行 |
| 450 | 不允许外出 |
1.3.6. 响应体示例¶
{
"responseId":7976321,
"gateAction":11,
"statusCode":200,
"description":"正常通行",
"type":"NI",
"id":"110101197608056896",
"name":"张三",
"flightDate":"2018-10-10",
"flightNo":"CA1234",
"departure":"TAO",
"destination":"CAN",
"seatNo":"SN37A",
"boardNo":"123"
}