• 257
  • 64
  • 53

火车票抢票

聚合数据 企业专用

根据乘客的车次与座席要求快速订票出票,业务特殊需要请联系在线客服

  • 按实际订单计费

¥ *** 价格详情请联系客服

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://v.juhe.cn/grabTicket/action/dataDictionary.php
返回格式:json
请求方式:get post
请求示例:http://v.juhe.cn/grabTicket/action/dataDictionary.php?key=你申请的key
接口备注:返回接口相关的字段使用场景及含义

请求参数说明:

名称 必填 类型 说明

返回参数说明:

名称 类型 说明

JSON返回示例:

{
    "reason": "success",
    "result": {
        "tips": [
            "抢票单暂时不可以购买保险",
            "抢票单目前最多支持五名乘客",
            "抢票单目前暂不支持学生票和残军票",
            "选择备选车次、备选坐席等均可提高抢票成功率",
            "申请退票流程是针对订单中的车票而非针对订单",
            "申请退票只支持单张车票,如多人退票需每张车票单独申请",
            "测试单请创建发车日期在20天以后的,因为会产生真实的费用",
            "在抢票有效时间内会持续抢票,抢票成功后直接出票并回调给用户",
            "抢票有效时间内未抢到票,我们会主动推送抢票单过期信息",
            "正在抢票中的订单可以取消,取消后不可再次开启。建议您不要轻易取消抢票",
            "抢票单默认使用合并推送,用户需要提供占座和出票合并网关以便正常接收到数据",
            "距离发车时间太近无法抢票,建议用户限制距离发车前3小时以上的车次才可创建抢票单",
            "抢票单的订单状态可以调用订单详情接口查看,抢票成功后更为详尽的订单信息可调用订单详情接口获取,此时需要加上issue参数"
        ],
        "idType": {
            "msg": "证件类型,一般用在创建订单的idType字段",
            "data": {
                "1": "身份证",
                "2": "护照",
                "3": "台胞证",
                "4": "港澳通行证"
            }
        },
        "passengerType": {
            "msg": "乘客类型,一般用在创建订单的passengerType字段",
            "data": {
                "1": "成人",
                "2": "儿童",
                "3": "学生票",
                "4": "残军票"
            }
        },
        "refundType": {
            "msg": "退款类型,一般用在退款结果推送接口",
            "data": {
                "0": "change:改签差价退款",
                "1": "repeatpay:重复支付退款",
                "2": "delaypay:延迟支付退款",
                "online": "线上退票退款",
                "offline": "车站退票退款",
                "issuefail": "出票失败退款",
                "other": "其他原因退款"
            }
        },
        "seatClass": {
            "msg": "一般用在回调出票成功后的passengers数组中的seatClass中",
            "data": {
                "1": "硬座",
                "2": "软座",
                "3": "一等座",
                "4": "二等座",
                "5": "硬卧上铺",
                "6": "硬卧",
                "7": "硬卧下铺",
                "8": "软卧上铺",
                "9": "软卧",
                "10": "无座",
                "11": "商务座",
                "12": "特等座",
                "13": "其它",
                "14": "高级软卧",
                "15": "动卧上铺",
                "16": "动卧下铺",
                "17": "高级动卧上铺",
                "18": "高级动卧下铺",
                "33": "一等软座",
                "44": "二等软座"
            }
        },
        "seatClassCode": {
            "msg": "一般用在站站查询返回的json数据及创建订单时候的seatClassCode和mainSeatClass字段",
            "data": {
                "hardseat": "硬座",
                "softseat": "软座",
                "firstseat": "一等座",
                "secondseat": "二等座",
                "hardsleeperup": "硬卧上铺",
                "hardsleepermid": "硬卧中铺",
                "hardsleeperdown": "硬卧下铺",
                "softsleeperup": "软卧上铺",
                "softsleeperdown": "软卧下铺",
                "noseat": "无座",
                "businessseat": "商务座",
                "specialseat": "特等座",
                "advancedsoftsleeper": "高级软卧",
                "otherseat": "其他"
            }
        },
        "trainClass": {
            "msg": "一般用在站站查询返回的json数据中的trains数组中的trainClass字段",
            "data": {
                "C": "城际高速",
                "D": "动车组",
                "KT": "空调特快",
                "KKS": "空调快速",
                "KPK": "空调普快",
                "KPM": "空调普慢",
                "KS": "快速",
                "PK": "普快",
                "PM": "普慢",
                "XGZ": "香港直通车",
                "Z": "直达特快",
                "GD": "高速动车"
            }
        },
        "ticketStateCode": {
            "msg": "一般用在订单详情接口返回json数据中的passengers数组中的ticketStateCode字段(如无,请忽略)",
            "data": {
                "N": "未出票",
                "F": "已出票",
                "C": "退票中",
                "T": "已退票",
                "O": "退票失败",
                "Y": "改签中",
                "G": "已改签"
            }
        },
        "orderStatus": {
            "msg": "一般用在订单详情接口返回的json数据中的grabOrderDetailInfo中的status字段",
            "data": {
                "N": "抢票单已创建",
                "B": "未到开抢时间",
                "D": "抢票中",
                "F": "抢票成功(出票成功)",
                "U": "出票失败",
                "O": "已过期",
                "C": "已取消",
                "T": "已退票",
                "E": "已改签"
            }
        },
        "msgCode": {
            "msg": "一般用在回调接口中(所有的回调的接口),所有的状态都是有可能返回的",
            "data": {
                "100": "请求成功",
                "101": "参数无效",
                "102": "签名验证失败",
                "103": "该IP没有权限访问此接口",
                "104": "请求过于频繁,请稍后重试",
                "105": "没有权限访问此接口",
                "201": "该订单不存在",
                "202": "当前订单状态不允许执行此操作",
                "203": "当前时间不支持此服务",
                "204": "坐席无效",
                "205": "发车日期无效",
                "206": "取消次数过多,取消请求已锁定",
                "207": "订单已过期",
                "208": "车次号无效",
                "209": "该坐席已售完",
                "210": "该账号有未完成的订单,无法继续执行此操作",
                "211": "分销商身份验证无效",
                "212": "该订单未付款,无法出票",
                "213": "坐席价格错误",
                "214": "占座排队中,请等待占座结果",
                "215": "站站查询结果已过期,请重新查询",
                "216": "距离发车时间太近,无法执行此操作",
                "217": "实际占座为无座,乘客制定不接受无座",
                "218": "测试订单不允许预定20天以内发车的车次",
                "219": "抢票单已达预约上限",
                "220": "抢票单乘客数,车次数,坐席数超过配置上限",
                "221": "抢票取消失败",
                "222": "抢票功能关闭",
                "301": "该订单中无此乘客",
                "302": "乘客身份信息涉嫌被他人冒用",
                "303": "当前车票状态不允许执行此操作",
                "304": "乘客信息不正确",
                "305": "乘客已预订过与该行程有冲突的车票",
                "306": "乘客已被法院依法限制高消费",
                "307": "乘客已预订过该车次,无法重复预订",
                "308": "乘客身份信息未通过验证",
                "309": "出票5分钟内无法提交退票",
                "310": "距离发车时间太近,无法申请退票",
                "311": "订单中包含儿童票,如需退票请先退儿童票",
                "312": "不支持网上退票",
                "313": "订单中包含儿童票,该乘客无法改签",
                "314": "距离发车时间太近,无法改签",
                "315": "要改签的车次不在预售期内,无法改签",
                "316": "该订单不支持改签",
                "317": "改签次数过多,改签请求已锁定",
                "318": "当天取消改签次数过多,取消请求已锁定",
                "319": "购保失败",
                "320": "退保失败",
                "401": "购票所使用的12306账号未进行手机核验",
                "402": "购票所使用的12306账号被封,无法执行此操作",
                "403": "12306账号登录失败",
                "404": "12306账号尚未激活,请用注册时的邮箱激活后重试",
                "405": "12306账号未通过身份信息核验,请核验后重试",
                "406": "12306账号已被锁定",
                "407": "登录验证码错误",
                "408": "12306账号格式不正确",
                "409": "12306账号常用联系人已达上限,无法继续添加",
                "410": "当日获取短信验证码次数已达上限",
                "411": "邮箱已被注册",
                "412": "用户名已被注册",
                "413": "手机号码已被注册",
                "414": "证件号码已被注册",
                "415": "12306账号不可用",
                "416": "手机号或证件号码不正确",
                "417": "该联系人已存在",
                "999": "未知的失败原因"
            }
        }
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  225700 网络繁忙,请稍后重试
  225701 供应商错误信息提示,具体看接口返回
  225702 订单号不存在
  225703 订单号已经存在
  225704 各种参数错误,具体看接口返回

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1537565109

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-8827-715
  在线客服QQ: 800076065

猜你喜欢

现在注册,百款接口免费测试

免费注册