12306查票模块接口协议分析

1.抓包结果

Charles抓包结果

2. 请求类型：

GET请求

3. 请求url：

https://kyfw.12306.cn/otn/leftTicket/query?leftTicketDTO.train_date=2020-03-09&leftTicketDTO.from_station=BJP&leftTicketDTO.to_station=SHH&purpose_codes=ADULT

4. 请求参数：

请求参数列表

train_date 是要出发的时间
from_station 是出发站
to_station 是达到站
purpose_codes 是票的类型（成人票/学生票）

5. 携带的Cookie

携带的Cookie

其中RAIL_EXPIRATION和RAIL_DEVICEID是需要客户端主动设置的，关于如何获取RAIL_EXPIRATION和RAIL_DEVICEID可以查看我的另一篇文章。

6. 结果解析

返回结果是一个JSON对象

其中result是一个字符串数组，每个字符串包含了一趟列次的详细信息，如下所示。

"tgVBJ7wd0jZEBRuU43sYAZDMY7KBRqXSoPGe5sgjPiibwfiWqZq5hGpDvehieVjfTVTQw%2F1xsmCX%0Ad1EnAgq9dxEd7B%2B06iCi8dnYAlXAQEKUzXkqn34EycNWmTd2A2e2N0Cypan8htcIjeZ1C1nuJ9H0%0ADiyWhdJ%2BWIYQUdVQQ%2FJiPPrHOMnmrKP09jqwlBoiL7C%2FhW0GhGLWoTpTo38IyoUUuaamt4WVpwdV%0ABpX2qqyWfROvsl4uUeTqG0aHN5LTlnbYr5M90DYbFvTd09L7ng8EWq7HgTF0hRh7XOQgBsM0kNWn%0Av3yA4Q%3D%3D|预订|240000G1050O|G105|VNP|AOH|VNP|AOH|07:20|13:08|05:48|Y|INlEaOtJiYUT9R%2F3WV4QXeQzRWdYineLGjTPjDZ7zB8tkCUR|20200309|3|P4|01|10|1|0|||||||||||有|1|1||O0M090|OM9|1|0|||||||||"

对于一趟车次，详细信息用'|'隔开，每个字段的含义如下所示。

/**
 * 余票查询时每个字段等含义
 */
public enum TicketField {
    SECRET_STR(0, "车票密钥，下单时用"),
    REMARK(1, "备注（预定/列车停运/几点起售）"),
    TRAIN_NO(2, "列车号(240000G41501)，查票价时用"),
    TRAIN_CODE(3, "车次(G415)"),
    START_STATION_CODE(4, "起始站代码"),
    END_STATION_CODE(5, "终点站代码"),
    FROM_STATION_CODE(6, "出发站代码"),
    TO_STATION_CODE(7, "到达站代码"),
    FROM_TIME(8, "出发时间"),
    TO_TIME(9, "到达时间"),
    DURATION(10, "历经多久"),
    CAN_BUY(11, "是否可以购买(Y/N)"),
    START_DATE(13, "列车起始站发车日期(20200123)"),
    TRAIN_LOCATION(15, "train_location"),
    FROM_STATION_NO(16, "出发站站序 01表示始发站，大于1表示过站"),
    TO_STATION_NO(17, "到达站序，对应火车经停的站序"),
    IS_SUPPORT_CARD(18, "可否使用二代身份证进出站 1可以，0不可以"),
    HIGH_SOFT_SLEEP_COUNT(21, "高级软卧等数量"),
    OTHER(22, "其它"),
    SOFT_SLEEP_COUNT(23, "软卧/一等卧数量"),
    SOFT_SEAT_COUNT(24, "软座数量"),
    SPECIAL_SEAT_COUNT(25, "特等座数量"),
    NONE_SEAT_COUNT(26, "无座数量"),
    YB_COUNT(27, "无座数量"),
    HARD_SLEEP_COUNT(28, "硬卧/二等卧数量"),
    HARD_SEAT_COUNT(29, "硬座数量"),
    SECOND_SEAT_COUNT(30, "二等座数量"),
    FIRST_SEAT_COUNT(31, "一等座数量"),
    BUSINESS_SEAT_COUNT(32, "商务座/特等座数量"),
    MOTOR_SLEEP_COUNT(33, "动卧数量"),
    SEAT_TYPES(35, "查询车票价格时的字段"),
    CAN_BACKUP(37, "是否支持候补,0不支持，1支持");

    int i;
    String desc;
    TicketField(int i, String desc) {
        this.i = i;
        this.desc = desc;
    }
}