机票验真
接口描述
如果您已使用电子客票,在客票所有航段使用27天内可以验证。
如果电子客票未被使用,在客票购买当天起一年内可以提供验证。
您也可以登录中国航信信天游网站 www.travelsky.com 校验客票的真实性。
请求方式
POST
请求地址
https://qst.imfbp.com/apihub/api
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| Action | String | 是 | 操作的接口名称,本接口取值:AirTicketVerify。 |
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| Timestamp | String | 是 | 公共参数。 |
| SecretId | String | 是 | 公共参数。 |
| Signature | String | 是 | 公共参数。 |
| Algorithm | String | 否 | 公共参数。 |
| Content-Type | String | 是 | 取值:application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| ticketNo | String | 是 | 电子客票号 |
| psgName | String | 是 | 旅客姓名 |
返回参数
公共返回参数
| 参数名称 | 类型 | 说明 |
|---|
| code | Integer | 200 表示请求成功,其他参见错误码 |
| message | String | 错误提示信息 |
| startTime | long | 开始时间 |
| endTime | long | 结束时间 |
| callId | long | 调用记录主键 |
| data | Object | 识别结果 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|
| startTime | long | 请求开始毫秒 |
| endTime | long | 请求结束毫秒 |
| invoiceList | [] | 行程单具体信息,验真结果为真票是返回,否则不返回,具体参见航空运输电子客票行程单 |
| invoiceValidationList | [] | 查验结果,验真结果为真票是返回,否则不返回 |
查验结果
| 参数名称 | 类型 | 说明 |
|---|
| validateCode | Integer | 10000 表示查验成功,其他表示识别,具体错误信息查看 message |
| message | String | 提示信息 |
| invoiceNum | String | 电子客票号 |
| invoiceTypeCode | Integer | 默认返回 6 |
错误码
若请求错误,服务器将返回的JSON文本包含以下参数:
- code:错误码。
- message:错误描述信息,帮助理解和解决发生的错误。
| 错误码 | 描述 |
|---|
| 11001 | 机票验真失败 |
| 11002 | 机票验真处理失败 |
| 4001 | 调用SDK权限校验不通过! |
| 4002 | 调用接口Action不能为空! |
| 4003 | API名称出错! |
| 4004 | SecretId不能为空! |
| 4005 | Timestamp不能为空! |
| 4006 | Signature不能为空! |
| 4007 | 用户没有调用当前API的权限! |
| 4008 | 签名不正确 |
| 4009 | 查询用户密钥为空,请联系管理员 |
| 4010 | 无当前接口权限 |
| 4011 | Timestamp与服务器接收到请求的时间相差不得超过五分钟 |
| 4012 | apicode不能为空! |
| 4013 | apicode未关联客户! |
| 5001 | 不支持的请求方式 |
| 6001 | 套餐包余量不足 |
| 6002 | 未开通访问此API套餐 |