POST api/CheckTicket/Continue/V5
检票后续操作,2023-06-13修改,添加了发起检票的凭据类型参数;添加了系统要求的检票凭证类型的返回。 本API的操作与api/CheckTicket/Continue是等价的,但输入和输出参数均不相同(不同的版本)。 注意,2023-06-13以后的系统,不论是否有人脸识别,都用此接口执行检票后续操作(不适用于FJC694)。 使用api/CheckTicket/ByBarCode或api/CheckTicket/ByIdCode接口发起检票后,如果票需要认证身份证、指纹或面相,获得返回的“checkresultcode”为0(表示当前票可以检或已检),“jpwc”为“0”表示检票未完成,需要后续操作时,检票终端需依据"rzfs"(认证方式)采样生物特征样本或对比生物特征样本后,再调用本API完成检票的实际操作。
Request Information
URI Parameters
None.
Body Parameters
TicketCheckParmV5Name | Description | Type | Additional information |
---|---|---|---|
MediaType |
介质类型。 当用户直接用条码开始检票,此值取值为‘B'; 当用户通过人脸识别,人脸仪在本地库中查询匹配成功后,获得票号(相当于条码)发起检票的,此值取值为“F”; 当手持机强制验票时,此值取值为“Q”; 当使用二代证、电子护照发起检票时,此值取值为“I”; 当使用IC卡发起验票时,此值取值为“U" 当使用二代证,但人脸仪已前置进行过“人证比对的”,此值取值为I。 当用户通过人脸识别,人脸仪在本地库中本询匹配成功后,获得二代证号(证件号)发起检票的,此值取值为“F”; 以上都不是,取值为“O". 非常重要的参数。 |
string |
Required Max length: 1 Min length: 1 |
lbsbh |
门票的内部识别号 |
string |
Required Max length: 32 |
zjlx |
证件类型,"1"身份证,“2”护照,“3”其他 |
string |
Max length: 1 |
zjhm |
证件号码 |
string |
Max length: 32 |
xm |
姓名 |
string |
Max length: 32 |
updatebiodata |
要求服务器更新生特特征信息,"1"必须更新,“0”不必更新。 |
string |
Required Max length: 1 |
bioinfo1 |
第一个生物特征特征值(可能是指纹,可能是面相),如果为空,表示在前面的流程中,尚未采集,此值如果不为空,则表示是需要认证的标本。 |
Collection of byte |
None. |
bioinfo2 |
第二个生物特征特征值(可能是指纹,可能是面相),如果为空,表示在前面的流程中,尚未采集,此值如果不为空,则表示是需要认证的标本。 |
Collection of byte |
None. |
bioinfo3 |
第三个生物特征特征值(可能是指纹,可能是面相),如果为空,表示在前面的流程中,尚未采集,此值如果不为空,则表示是需要认证的标本。 |
Collection of byte |
None. |
bioinfo4 |
第四个生物特征特征值(可能是指纹,可能是面相),如果为空,表示在前面的流程中,尚未采集,此值如果不为空,则表示是需要认证的标本。 |
Collection of byte |
None. |
gateparm |
检票时需要的闸机参数 |
CheckGateParm |
Required |
Request Formats
application/json, text/json
{ "MediaType": "sample string 1", "lbsbh": "sample string 2", "zjlx": "sample string 3", "zjhm": "sample string 4", "xm": "sample string 5", "updatebiodata": "sample string 6", "bioinfo1": "QEA=", "bioinfo2": "QEA=", "bioinfo3": "QEA=", "bioinfo4": "QEA=", "gateparm": { "dzid": "sample string 1", "jpfx": "sample string 2", "cansamplefinger": "sample string 3", "cansampleface": "sample string 4", "cansampleidentitycard": "sample string 5", "machinetype": "sample string 6" } }
application/xml, text/xml
<TicketCheckParmV5 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm"> <bioinfo1>QEA=</bioinfo1> <bioinfo2>QEA=</bioinfo2> <bioinfo3>QEA=</bioinfo3> <bioinfo4>QEA=</bioinfo4> <gateparm> <cansampleface>sample string 4</cansampleface> <cansamplefinger>sample string 3</cansamplefinger> <cansampleidentitycard>sample string 5</cansampleidentitycard> <dzid>sample string 1</dzid> <jpfx>sample string 2</jpfx> <machinetype>sample string 6</machinetype> </gateparm> <lbsbh>sample string 2</lbsbh> <updatebiodata>sample string 6</updatebiodata> <xm>sample string 5</xm> <zjhm>sample string 4</zjhm> <zjlx>sample string 3</zjlx> <MediaType>sample string 1</MediaType> </TicketCheckParmV5>
application/x-www-form-urlencoded
Sample not available.
application/bson
Binary JSON content. See http://bsonspec.org for details.
Response Information
Resource Description
检票后续操作,2023-06-13修改,添加了发起检票的凭据类型参数;添加了系统要求的检票凭证类型的返回。 本API的操作与api/CheckTicket/Continue是等价的,但输入和输出参数均不相同(不同的版本)。 注意,2023-06-13以后的系统,不论是否有人脸识别,都用此接口执行检票后续操作(不适用于FJC694)。 使用api/CheckTicket/ByBarCode或api/CheckTicket/ByIdCode接口发起检票后,如果票需要认证身份证、指纹或面相,获得返回的“checkresultcode”为0(表示当前票可以检或已检),“jpwc”为“0”表示检票未完成,需要后续操作时,检票终端需依据"rzfs"(认证方式)采样生物特征样本或对比生物特征样本后,再调用本API完成检票的实际操作。
TicketCheckingResult2V5Name | Description | Type | Additional information |
---|---|---|---|
CheckInMediaType |
限定的检票进入的介质类型 A任意,B限条码 I限二代证,F限人脸 P限指纹 U限IC卡 |
string |
None. |
lbsbh |
内部识别号 |
string |
None. |
jpfx |
检票方向,“I”表示检入,“O”表示检出。 |
string |
None. |
dzid |
闸机ID |
string |
None. |
checkresultcode |
检票的返回结果 |
integer |
None. |
checkresult |
检票结果的描述 |
string |
None. |
rcs |
当前票的人次数 |
integer |
None. |
scjp |
是否首次检票,“1”表示是第一次检票,“0”表示不是第一次检票。这是指整个票的生命周期中,是否第一次使用。 |
string |
None. |
sytxcs |
当前闸机所在检票站点的剩余通行次数, 表示此次检票后剩余的许可次数。 |
integer |
None. |
tslx |
提示的类型,“1”常规提示,如“请进”“请通行”;“2”提示“请验证件”或“请核对证件”。 |
string |
None. |
Response Formats
application/json, text/json
{ "CheckInMediaType": "sample string 1", "lbsbh": "sample string 2", "jpfx": "sample string 3", "dzid": "sample string 4", "checkresultcode": 5, "checkresult": "sample string 6", "rcs": 7, "scjp": "sample string 8", "sytxcs": 9, "tslx": "sample string 10" }
application/xml, text/xml
<TicketCheckingResult2V5 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result"> <checkresult>sample string 6</checkresult> <checkresultcode>5</checkresultcode> <dzid>sample string 4</dzid> <jpfx>sample string 3</jpfx> <lbsbh>sample string 2</lbsbh> <rcs>7</rcs> <scjp>sample string 8</scjp> <sytxcs>9</sytxcs> <tslx>sample string 10</tslx> <CheckInMediaType>sample string 1</CheckInMediaType> </TicketCheckingResult2V5>
application/bson
Binary JSON content. See http://bsonspec.org for details.