1、目次前言引言1 范围12 规范性引用文件13 术语和定义、缩略语14 通用要求15 报文结构36 系统接口3附录 A(规范性)接口内容5JT/T 1433.22022前言本文件按照 GB/T 1.12020标准化工作导则 第 1 部分:标准化文件的结构和起草规则的规定起草。本文件是 JT/T 1433水路客运电子船票系统技术规范的第 2 部分。JT/T 1433 已经发布了以下部分:第 1 部分:电子船票;第 2 部分:服务接口。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由交通运输信息通信及导航标准化技术委员会提出并归口。本文件起草单位:中国交通通信信息中
2、心、中交信有限责任公司、大连市水路运输协会、大连港客运总公司、交通运输部烟台打捞局、海南港航控股有限公司、重庆航运交易所邮轮旅游服务公司。本文件主要起草人:张鹏、邓英、姜锋俊、鲍雨新、张明伟、朱火孟、陈本锡、解超、于渤、张勇、郑力、张亮、蔡迎、耿奕伟、陈献国。JT/T 1433.22022引言JT/T 1433水路客运电子船票系统技术规范用于指导水路客运电子船票系统建设,为实现跨区域联网售票和跨交通运输方式的联程运输奠定基础。JT/T 1433 旨在规范水路客运电子船票的信息、凭证以及电子船票系统的服务接口,由两个部分构成。第 1 部分:电子船票。目的在于统一电子船票的信息内容及样式,方便进行
3、信息交换和互联互通。第 2 部分:服务接口。目的在于统一水路客运电子船票系统的服务接口,便于快速进行系统对接,提高效率和节约成本。JT/T 1433.22022水路客运电子船票系统技术规范第 2 部分:服务接口1 范围本文件规定了水路客运电子船票系统服务接口的通用要求、报文结构和接口内容。本文件适用于水路客运电子船票系统服务接口的设计、开发和使用。2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。JT/T 697.8 交通信息基础数据元 第 8
4、 部分:水路运输信息基础数据元JT/T 979.1 道路客运联网售票系统 第 1 部分:服务接口规范JT/T 1433.12022 水路客运电子船票系统技术规范 第 1 部分:电子船票RFC 2616 超文本传输协议 HTTP/1.1(Hypertext Transfer Protocol-HTTP/1.1)3 术语和定义、缩略语3.1 术语和定义JT/T 697.8、JT/T 979.1、JT/T 1433.1 及 RFC 2616 中界定的术语和定义适用于本文件。3.2 缩略语下列缩略语适用于本文件。HTTP:超文本传输协议(Hypertext Transfer Protocol)JSON
5、:Java 脚本语言对象符号(JavaScript Object Notation)REST:表征状态转移(Representational State Transfer)SOA:面向服务架构(Service Oriented Architecture)URI:通用资源标识符(Uniform Resource Identifier)4 通用要求4.1 水路客运电子船票系统应基于 HTTP 协议进行通信。4.2 水路客运电子船票系统接口请求和返回数据应进行签名,校验数据的完整性。签名数据保存在HTTP 消息头中,业务数据保存在 HTTP 消息体中,使用 JSON 协议解析。4.3 接口请求响应通
6、用状态码应符合表 1 的规定。接口请求响应业务状态码应符合表 2 的规定。1JT/T 1433.22022表 1 接口请求响应通用状态码通用状态码说 明200服务调用成功400请求格式错误401未授权访问402不可识别403服务器拒绝访问404指定的资源未找到408请求超时500服务器内部错误504响应超时表 2 接口请求响应业务状态码业务状态码说 明10000成功10001请求格式错误10101航线信息授权异常10201船舶信息授权异常10301航班信息授权异常10401获取订单船票数量上限授权异常10501获取电子船票基础信息失败10601获取电子客票信息失败10701获取退票手续费失败10702该窗口不可退票10703退票操作失败10801获取预存款信息失败10901押金查询失败11001获取交易记录失败11002未获取到交易记录11201获取车辆类型信息失败11301获取车辆长度信息失败11401货物类型查询失败11501获取电子车票可选舱位信息失败11601获取电子车票票价信息失败11701获取退票原因失败11801锁定舱位订单提交失败2JT/T 1433.22022表 2
安全达人 