机票验真
接口描述
如果您已使用电子客票,在客票所有航段使用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套餐 |