项目简介
本项目是一个火车票在线订票接口(API),专为第三方网站快速接入官网而开发。客户端与接口使用简单的封装协议通讯,简化了第三方在线订票的接入流程。接口对外数据全部以http协议发布,请求采用POST方式,返回数据为JSON格式。
项目的主要特性和功能
- 用户授权与登录:测试期免费,用户可用12306.cn账号授权登录,登录含获取Token、生成验证码、验证码识别、校验等步骤,可判断登录状态及用户信息是否过期。
- 火车票查询:包括余票查询(查出发站、到达站、乘车日期对应的余票和票价信息)、时刻查询(根据时刻Token查车次详细时刻表)、正晚点查询(查列车在指定车站正晚点信息)。
- 在线订票:有订单信息获取、订单检查、提交队列、确认提交、等待订单、订单确认等完整订票流程。
- 订单支付:提供工商银行、农业银行、支付宝、微信支付等多种支付方式,根据支付信息组合成Form表单提交到支付页。
- 订单管理:可管理未支付订单(查看信息、取消订单)、已完成订单(按条件查询未出行订单和历史订单),有退票提醒和确认退票功能。
- 乘车人管理:可查询常用乘车人、乘车人列表,能添加、编辑、删除乘车人信息。
- 代售点查询:可查询省份、城市、县区列表及对应的代售点信息。
- 其他查询:支持汽车票查询,可根据出发城市、到达城市和日期查询汽车票信息。
安装使用步骤
- 确保已下载本项目的源码文件。
- 环境准备:安装PHP环境,且支持
curl
扩展,部分示例代码使用curl
进行HTTP请求。 - 配置测试账号:在代码中配置测试账号的
ACCESSID
和ACCESSKEY
,示例如下:php // 测试账号 ACCESSID: 10000 ACCESSKEY:9f6e6800cfae7749eb6c486619254b9c
- 字符编码设置:数据中心接口接收和返回统一以UTF - 8字符集编码格式进行,WEB应用需在网页头部添加: ```html
``
5. 调用接口:按文档中各接口说明,以POST方式请求对应的接口地址,传递相应参数,接收JSON格式的返回数据进行处理。例如,获取Token可请求:
http://openapi.chepiao100.com/v3.api?do=train.user.token` 。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】