POST api/CheckTicket/FaceType/ByBarCode

本API仅适用于FJC694，本API的返回值中，bioinfo1返回FJC694地平线特征值，BioInfo2中返回原始图片。 使用条码（含一维码，二维码、手机条码等情形），发起检票（仅适用于FJC694）。 获得的返回“checkresultcode”为0（表示当前票可以检或已检），“jpwc”为“0”表示检票未完成,需要后续操作；“jpwc”为“1”表示检票已完成。当“checkresultcode”为“0”且“jpwc”也为“0”时，检票终端需依据"rzfs"(认证方式）采样生物特征样本或对比生物特征样本后，再调用本其他API完成检票的后续操作。

Request Information

URI Parameters

None.

Body Parameters

TicketCheckByBarcodeFaceTypeParm
NameDescriptionTypeAdditional information
barcode

条码的内容

 string

Required
gateparm

检票时需要的闸机参数

 CheckGateParm

Required
facematched

是否已经过了人脸识别，‘1’表示已经过了人脸识别,'0'或空表示未经过人脸识别。

 string

Required

Request Formats

application/json, text/json

Sample: 
{
  "barcode": "sample string 1",
  "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"
  },
  "facematched": "sample string 2"
}

application/xml, text/xml

Sample: 
<TicketCheckByBarcodeFaceTypeParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm">
  <barcode>sample string 1</barcode>
  <facematched>sample string 2</facematched>
  <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>
</TicketCheckByBarcodeFaceTypeParm>

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

本API仅适用于FJC694，本API的返回值中，bioinfo1返回FJC694地平线特征值，BioInfo2中返回原始图片。 使用条码（含一维码，二维码、手机条码等情形），发起检票（仅适用于FJC694）。 获得的返回“checkresultcode”为0（表示当前票可以检或已检），“jpwc”为“0”表示检票未完成,需要后续操作；“jpwc”为“1”表示检票已完成。当“checkresultcode”为“0”且“jpwc”也为“0”时，检票终端需依据"rzfs"(认证方式）采样生物特征样本或对比生物特征样本后，再调用本其他API完成检票的后续操作。

TicketCheckingFaceTypeResult
NameDescriptionTypeAdditional information
lbsbh

内部识别号

 string

None.
jpfx

检票方向，“I”表示检入，“O”表示检出。

 string

None.
dzid

闸机ID

 string

None.
rzfs

认证方式，“1”仅有效性验证（只需要检查票是否合法，是否有效；“3”有效性+身份证核对；“4”有效性+指纹；“5”有效性+面相

 string

None.
jpwc

是否检票完成，“1”检票完成，没有后续流程，这通常发生在“仅有效性验证”时，一次访问可以完成检票；“0”表示仅给客户端返回了票的相关信息，需要客户端进行身份认证或其他操作之后再调用检票接口~/api/Checking/Continue接口。

 string

None.
yxqs

有效期始（YYYYMMDD）

 string

None.
yxqz

有效期止(YYYYMMDD)

 string

None.
mplxid

门票类型ID

 string

None.
mplxmc

门票类型的名称

 string

None.
additionalbioinfo

附属特征值。 2021-02-26添加。 专用于富士智能ZRS692，694，696PRO地平线算法的特征扩展属性。 这个值来源于注册时，从人脸设备上上传的同一个值。

 byte

None.
bioinfo1

(仅适用于FJC694),在其他场景下没有含义。 第一个生物特征特征值(可能是指纹，可能是面相)，如果为空，表示在前面的流程中，尚未采集，此值如果不为空，则表示是需要认证的标本。 如果SECUGEN指纹仪，则这个值是直接的指纹特征模板。 如果是地平线算法人脸仪，这个值的内容是地平线人脸模板特征值，但需要做如下处理：在Continue请求中，需要把采集的特征值转换为BYTE[]，在收到本参数的值时，需要转换为INT16[](至编写本文时止，地平线算法的人脸模板人征值为int16[])。

 Collection of byte

None.
bioinfo2

第二个生物特征特征值(可能是指纹，可能是面相)，如果为空，表示在前面的流程中，尚未采集，此值如果不为空，则表示是需要认证的标本。

 Collection of byte

None.
bioinfo3

第三个生物特征特征值(可能是指纹，可能是面相)，如果为空，表示在前面的流程中，尚未采集，此值如果不为空，则表示是需要认证的标本。

 Collection of byte

None.
bioinfo4

第四个生物特征特征值(可能是指纹，可能是面相)，如果为空，表示在前面的流程中，尚未采集，此值如果不为空，则表示是需要认证的标本。

 Collection of byte

None.
checkresultcode

检票的返回结果

 integer

None.
checkresult

检票结果的描述

 string

None.
rcs

当前票的人次数

 integer

None.
zjlx

证件类型代码,1身份证，2护照，3其他

 string

None.
zjmc

证件名称

 string

None.
zjhm

证件号码

 string

None.
xm

姓名

 string

None.
sprqsj

售票的日期时间,格式yyyyMMddHHmmss。

 string

None.
scjp

是否首次检票，“1”表示是第一次检票，“0”表示不是第一次检票。这是指整个票的生命周期中，是否第一次使用。

 string

None.
spzddm

售票站点代码

 string

None.
spzdmc

售票站点的名称

 string

None.
yqid

当前闸机，当前方向对应的园区的ID

 string

None.
yqmc

当前闸机，当前方向对应的园区的名称。

 string

None.
tslx

提示的类型，“1”常规提示，如“请进”“请通行”；“2”提示“请验证件”或“请核对证件”。

 string

None.
sytxcs

当前闸机所在检票站点的剩余通行次数，当jpwc=0时，表示当前仍剩余的通行许可次数，当jpwc=1时，表示此次检票后剩余的许可次数。

 integer

None.
lastcheckdzid

最后一次的检票道闸ID。 最后一次检票：指当前门票，在当前检票进入或离开的园区（依据dzid系统自动获提），当前检票方向（依据jpfx指定），最后一次成功检票的记录。 当检票返回“无此权限（-1015）”时，此数据可以用于向检票员展示，此票在哪个闸机上消费掉了。

 string

None.
lastcheckjpzdid

最后一次的检票站点ID。 最后一次检票：指当前门票，在当前检票进入或离开的园区（依据dzid系统自动获提），当前检票方向（依据jpfx指定），最后一次成功检票的记录。

 string

None.
lastcheckjpzdmc

最后一次检票的检票站点名称。 最后一次检票：指当前门票，在当前检票进入或离开的园区（依据dzid系统自动获提），当前检票方向（依据jpfx指定），最后一次成功检票的记录。

 string

None.
lastjprqsj

最后一次检票的日期时间 最后一次检票：指当前门票，在当前检票进入或离开的园区（依据dzid系统自动获提），当前检票方向（依据jpfx指定），最后一次成功检票的记录。

 string

None.
qtqx

'1'表示还有其他的通行权限,'0'表示没有其他的通行权限。

 string

None.

Response Formats

application/json, text/json

Sample: 
{
  "lbsbh": "sample string 1",
  "jpfx": "sample string 2",
  "dzid": "sample string 3",
  "rzfs": "sample string 4",
  "jpwc": "sample string 5",
  "yxqs": "sample string 6",
  "yxqz": "sample string 7",
  "mplxid": "sample string 8",
  "mplxmc": "sample string 9",
  "additionalbioinfo": 64,
  "bioinfo1": "QEA=",
  "bioinfo2": "QEA=",
  "bioinfo3": "QEA=",
  "bioinfo4": "QEA=",
  "checkresultcode": 11,
  "checkresult": "sample string 12",
  "rcs": 13,
  "zjlx": "sample string 14",
  "zjmc": "sample string 15",
  "zjhm": "sample string 16",
  "xm": "sample string 17",
  "sprqsj": "sample string 18",
  "scjp": "sample string 19",
  "spzddm": "sample string 20",
  "spzdmc": "sample string 21",
  "yqid": "sample string 22",
  "yqmc": "sample string 23",
  "tslx": "sample string 24",
  "sytxcs": 25,
  "lastcheckdzid": "sample string 26",
  "lastcheckjpzdid": "sample string 27",
  "lastcheckjpzdmc": "sample string 28",
  "lastjprqsj": "sample string 29",
  "qtqx": "sample string 30"
}

application/xml, text/xml

Sample: 
<TicketCheckingFaceTypeResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result">
  <additionalbioinfo>64</additionalbioinfo>
  <bioinfo1>QEA=</bioinfo1>
  <bioinfo2>QEA=</bioinfo2>
  <bioinfo3>QEA=</bioinfo3>
  <bioinfo4>QEA=</bioinfo4>
  <checkresult>sample string 12</checkresult>
  <checkresultcode>11</checkresultcode>
  <dzid>sample string 3</dzid>
  <jpfx>sample string 2</jpfx>
  <jpwc>sample string 5</jpwc>
  <lastcheckdzid>sample string 26</lastcheckdzid>
  <lastcheckjpzdid>sample string 27</lastcheckjpzdid>
  <lastcheckjpzdmc>sample string 28</lastcheckjpzdmc>
  <lastjprqsj>sample string 29</lastjprqsj>
  <lbsbh>sample string 1</lbsbh>
  <mplxid>sample string 8</mplxid>
  <mplxmc>sample string 9</mplxmc>
  <qtqx>sample string 30</qtqx>
  <rcs>13</rcs>
  <rzfs>sample string 4</rzfs>
  <scjp>sample string 19</scjp>
  <sprqsj>sample string 18</sprqsj>
  <spzddm>sample string 20</spzddm>
  <spzdmc>sample string 21</spzdmc>
  <sytxcs>25</sytxcs>
  <tslx>sample string 24</tslx>
  <xm>sample string 17</xm>
  <yqid>sample string 22</yqid>
  <yqmc>sample string 23</yqmc>
  <yxqs>sample string 6</yxqs>
  <yxqz>sample string 7</yxqz>
  <zjhm>sample string 16</zjhm>
  <zjlx>sample string 14</zjlx>
  <zjmc>sample string 15</zjmc>
</TicketCheckingFaceTypeResult>

application/bson

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