POST api/CheckTicket/ByIdCode
使用身份证发起检票。在人脸的使用场景中,不宜使用本API。 获得的返回“checkresultcode”为0(表示当前票可以检或已检),“jpwc”为“0”表示检票未完成,需要后续操作;“jpwc”为“1”表示检票已完成。当“checkresultcode”为“0”且“jpwc”也为“0”时,检票终端需依据"rzfs"(认证方式)采样生物特征样本或对比生物特征样本后,再调用本其他API完成检票的后续操作。
Request Information
URI Parameters
None.
Body Parameters
TicketCheckByIdentityCodeParm| Name | Description | Type | Additional information |
|---|---|---|---|
| identifycode |
身份证号 |
string |
Required |
| gateparm |
检票时需要的闸机参数 |
CheckGateParm |
Required |
Request Formats
application/json, text/json
{
"identifycode": "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"
}
}
application/xml, text/xml
<TicketCheckByIdentityCodeParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm">
<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>
<identifycode>sample string 1</identifycode>
</TicketCheckByIdentityCodeParm>
application/x-www-form-urlencoded
Sample not available.
application/bson
Binary JSON content. See http://bsonspec.org for details.
Response Information
Resource Description
使用身份证发起检票。在人脸的使用场景中,不宜使用本API。 获得的返回“checkresultcode”为0(表示当前票可以检或已检),“jpwc”为“0”表示检票未完成,需要后续操作;“jpwc”为“1”表示检票已完成。当“checkresultcode”为“0”且“jpwc”也为“0”时,检票终端需依据"rzfs"(认证方式)采样生物特征样本或对比生物特征样本后,再调用本其他API完成检票的后续操作。
TicketCheckingResult| Name | Description | Type | Additional 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. |
| bioinfo1 |
指纹特征1 |
Collection of byte |
None. |
| bioinfo2 |
指纹特征2 |
Collection of byte |
None. |
| bioinfo3 |
指纹特征3 |
Collection of byte |
None. |
| bioinfo4 |
指纹特征4 |
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. |
Response Formats
application/json, text/json
{
"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",
"bioinfo1": "QEA=",
"bioinfo2": "QEA=",
"bioinfo3": "QEA=",
"bioinfo4": "QEA=",
"checkresultcode": 10,
"checkresult": "sample string 11",
"rcs": 12,
"zjlx": "sample string 13",
"zjmc": "sample string 14",
"zjhm": "sample string 15",
"xm": "sample string 16",
"sprqsj": "sample string 17",
"scjp": "sample string 18",
"spzddm": "sample string 19",
"spzdmc": "sample string 20",
"yqid": "sample string 21",
"yqmc": "sample string 22",
"tslx": "sample string 23",
"sytxcs": 24,
"lastcheckdzid": "sample string 25",
"lastcheckjpzdid": "sample string 26",
"lastcheckjpzdmc": "sample string 27",
"lastjprqsj": "sample string 28"
}
application/xml, text/xml
<TicketCheckingResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result"> <bioinfo1>QEA=</bioinfo1> <bioinfo2>QEA=</bioinfo2> <bioinfo3>QEA=</bioinfo3> <bioinfo4>QEA=</bioinfo4> <checkresult>sample string 11</checkresult> <checkresultcode>10</checkresultcode> <dzid>sample string 3</dzid> <jpfx>sample string 2</jpfx> <jpwc>sample string 5</jpwc> <lastcheckdzid>sample string 25</lastcheckdzid> <lastcheckjpzdid>sample string 26</lastcheckjpzdid> <lastcheckjpzdmc>sample string 27</lastcheckjpzdmc> <lastjprqsj>sample string 28</lastjprqsj> <lbsbh>sample string 1</lbsbh> <mplxid>sample string 8</mplxid> <mplxmc>sample string 9</mplxmc> <rcs>12</rcs> <rzfs>sample string 4</rzfs> <scjp>sample string 18</scjp> <sprqsj>sample string 17</sprqsj> <spzddm>sample string 19</spzddm> <spzdmc>sample string 20</spzdmc> <sytxcs>24</sytxcs> <tslx>sample string 23</tslx> <xm>sample string 16</xm> <yqid>sample string 21</yqid> <yqmc>sample string 22</yqmc> <yxqs>sample string 6</yxqs> <yxqz>sample string 7</yxqz> <zjhm>sample string 15</zjhm> <zjlx>sample string 13</zjlx> <zjmc>sample string 14</zjmc> </TicketCheckingResult>
application/bson
Binary JSON content. See http://bsonspec.org for details.