• 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):

  错误码 说明

系统级错误码参照:

  错误码 说明 旧版本(resultcode)

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

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

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

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

联系我们

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

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

免费注册