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

TicketCheckParmV5
NameDescriptionTypeAdditional 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

Sample:
{
  "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

Sample:
<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:

Sample not available.

application/bson

Sample:
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完成检票的实际操作。

TicketCheckingResult2V5
NameDescriptionTypeAdditional 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

Sample:
{
  "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

Sample:
<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

Sample:
Binary JSON content. See http://bsonspec.org for details.