水路客运电子船票系统服务接口技术实现语法格式.pdf

接口技术实现语法格式 接口技术实现公共信息 公共信息内容 基于水运客运电子船票系统，提供了查询航次列表、航次详情、锁座、出票、退票费查询、退票、 查询等一系列接口，通过调用接口，可以实现整套网络售票流程。 适用于第三方的网络售票代理商，第三方可通过接口调用完成订单级的查询、出票、退票等操作。 公共信息定义 公共信息定义如表 A.1 所示。 公共信息定义 名称 含义 类型 是否必填 示例值 特殊说明 sysCode 授权码 String 是 A42E 调用方被授权后获得该 code sign 签名 String 是 CK12 签名 sign 后的值 argsValue 电子票号数组 String 是 见示例 参数加密后的值 接口技术实现详细语法格式 查询航线信息 接口声明 public String getBsRoutes(String) 。 A.2.1.2 接口说明 通过调用该接口，返回所有的航线信息。 A.2.1.3 请求内容 请求内容定义见表 A.2 。 查询航线信息请求内容 名称 含义 类型 是否必填 示例值 特殊说明 sysCode 接口授权 code String 是 A42E 调用方被授权后获 得该 code requestId 请求标识 String 是 r123456 A.2.1.4 返回内容 返回内容定义见表 A.3 。 查询航线信息返回内容 名称 含义 类型 示例值 特殊说明 status 状态 int 详见状态码说明 0 成功， -1 失败 sysCode 接口授权 code String A42E apiDesc 接口描述 String 获取航线信息 requestId 请求标识 String r123456 msg 消息 String 失败后显示失败原因 id 航线 id String A1234 32 位 name 航线名称 String 大连 - 烟台 code 航线编码 String A123 startPort 始发港 String 大连港 endPort 目的港 String 烟台港 查询船舶信息 接口声明 public String getBsShips(String) ; 接口说明 通过调用该接口，返回船舶信息。 请求内容 请求内容定义见表 A.4 。 查询船舶信息请求内容 名称