JT∕T 1415.3-2022 交通运输数据资源交换与共享 第3部分:数据格式与接口.pdf
《JT∕T 1415.3-2022 交通运输数据资源交换与共享 第3部分:数据格式与接口.pdf》由会员分享,可在线阅读,更多相关《JT∕T 1415.3-2022 交通运输数据资源交换与共享 第3部分:数据格式与接口.pdf(15页珍藏版)》请在咨信网上搜索。
1、ICS 35.240.60CCS R 07中华人民共和国交通运输行业标准JT / T 1415. 32022交通运输数据资源交换与共享第 3 部分:数据格式与接口Transportation data exchanging and sharingPart 3:Data format and interface2022-01-13 发布2022-04-13 实施中华人民共和国交通运输部发 布目次前言引言1 范围12 规范性引用文件13 术语和定义、缩略语14 资源共享要求15 资源交换要求5附录 A(资料性) 结构化数据文件内容示例7附录 B(规范性) 控制文件和应答文件格式8参考文献11JT/
2、 T 1415.32022前言本文件按照 GB/ T 1. 12020标准化工作导则 第1 部分:标准化文件的结构和起草规则的规定起草。本文件是 JT/ T 1415交通运输数据资源交换与共享的第 3 部分。 JT/ T 1415 已经发布了以下部分: 第 1 部分:总体架构; 第 2 部分:通用技术要求; 第 3 部分:数据格式与接口。请注意本文件的某些内容可能涉及专利。 本文件的发布机构不承担识别专利的责任。本文件由交通运输信息通信及导航标准化技术委员会提出并归口。本文件起草单位:交通运输部科学研究院、长城计算机软件与系统有限公司、贵州省交通运输厅、贵州银智科技发展有限公司。本文件主要起草
3、人:郭明多、李洪囤、杨艳芳、黄莉莉、曹剑东、陈博、段成民、刘娜、田璐、郭亚茹、张莉、周雷、尚华、田仁薪、杨波、王君、张冰冰、李政达、康厚荣。JT/ T 1415.32022引言在交通运输数据资源共享交换的总体架构、通用技术和数据格式与接口等方面提出统一要求,有利于进一步实现行业数据资源高效共享与开发利用,对完善交通运输行业数据资源共享交换体系具有重要意义。 JT/ T 1415 由三个部分构成: 第 1 部分:总体架构。 目的是规范交通运输数据资源共享交换平台的体系架构、功能架构、业务架构等总体架构。 第 2 部分:通用技术要求。 目的是提出交通运输数据资源共享交换的共享、交换、日志、部署环境
4、和数据安全等通用技术要求。 第 3 部分:数据格式与接口。 目的是规范交通运输数据资源共享交换平台资源共享和交换的数据格式与接口要求。JT/ T 1415.32022交通运输数据资源交换与共享第 3 部分:数据格式与接口1 范围本文件规定了交通运输数据资源共享交换平台的资源共享要求和资源交换要求。本文件适用于交通运输数据资源共享交换平台的数据格式与接口的规划、设计、建设和运维。2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GM/ T 00
5、042012 SM3 密码杂凑算法JT/ T 1415. 22022 交通运输数据资源交换与共享 第 2 部分:通用技术要求IETF RFC 1945 超文本传输协议 1. 0(Hypertext Transfer Protocol 1. 0)IETF RFC 2616 超文本传输协议 1. 1(Hypertext Transfer Protocol 1. 1)W3C 简单对象访问协议 1. 1(Simple Object Access Protocol 1. 1)W3C 简单对象访问协议 1. 2(Simple Object Access Protocol 1. 2)3 术语和定义、缩略语3
6、.1 术语和定义JT/ T 1415. 2 界定的术语和定义适用于本文件。3.2 缩略语下列缩略语适用于本文件。ANSI:美国国家标准学会(American National Standards Institute)GBK:汉字内码扩展规范(Guo Biao Kuozhan)SFTP:安全文件传输协议(Secure File Transfer Protocol)UTF-8:Unicode 的可变长度字符编码(8-bit Unicode Transformation Format)4 资源共享要求4.1 数据库要求以数据库方式提供资源时,数据更新方式分为全量更新和增量更新。 全量更新的数据字段中
7、应包含主键。 增量更新的数据字段应包含主键、时间戳和操作标识,其中操作标识中“C”代表增量新增,“D”代表增量删除。 若存在主键缺失的情况,应设置联合主键。1JT/ T 1415.320224.2 数据文件要求4.2.1 基本要求以数据文件方式提供资源时,应包括结构化数据文件和附件文件夹,结构化数据文件是特定字符分隔文本文件,当无附件时,附件文件夹为空。4.2.2 文件格式结构化数据文件应为 csv 格式,附件文件可包括图像、文档、音视频等格式类型。数据文件压缩应满足以下要求:a) 同一批次仅有一个结构化数据文件时无需压缩。b) 同一批次包含多个结构化数据文件且有执行顺序要求时,应将多个文件压
8、缩为一个 ZIP 文件,并提供索引信息,索引信息具体要求符合 4. 2. 5。c) 有附件时应将同一批次的结构化数据文件和附件文件夹压缩为一个 ZIP 文件。4.2.3 文件命名4.2.3.1 结构化数据文件命名结构化数据文件应以“业务编码-资源编码-时间戳. 后缀名”格式命名,其中:a) 业务编码:唯一标识其所属业务,由 10 位 ASCII 字符组成:前 6 位为大写字母,采用信息系统简称的拼音首字母;后 4 位为数字字符,用于区分同一信息系统的不同传输业务。b) 资源编码:唯一标识对应的数据资源,具体编码在注册资源时由部级共享平台或省级交通共享平台生成。c) 时间戳:标识生成时间,格式为
9、 24 小时制时间格式“YYYYMMDDhhmmss”。d) 后缀名:标识数据格式,如. csv。示例:SJHJYW0000-014GL04OATGCA0001-20180726153000. csv4.2.3.2 附件命名附件名包括显示名和文件名,其中文件名应以附件内容的哈希值命名。4.2.4 文件内容结构化数据文件内容应符合以下要求:a) 第一行为字段名称,使用西文半角符号“, ”进行分隔。b) 每条记录存为一行,每行数据应以回车换行( rn)分隔。c) 数据项之间以西文半角符号“,”进行分隔。d) 数据内容以西文半角双引号()限定,数据内容包含双引号时,用转义字符( )表示。提供资源含附
10、件时,结构化数据文件内容还应包含该附件显示名和文件名字段。 结构化数据文件内容示例见附录 A。4.2.5 索引信息索引信息位于控制文件(见 5. 2. 2)的业务附加信息中,用于标识同一批次内结构化数据文件的执行顺序,根据该顺序实现资源提供与服务使用。 控制文件的业务附加信息应符合附录 B 的规定。索引信息中每段信息格式为:结构化数据文件名称 + “:” + 操作标识 + 换行符。 其中,操作标识用于标识该数据文件中数据的操作类型,U 代表全量更新, C 代表增量新增,D 代表增量删除。示例 1:SJHJYW0000-014GL04OATGCA0001-20200726153000. csv:
11、C2JT/ T 1415.32022示例 2:SJHJYW0000-014GL04OATGCA0001-20200727153000. csv:D4.3 接口要求4.3.1 接口分类接口分为认证接口和业务接口两类。 认证接口用于验证调用者身份的合法性,业务接口用于提供数据资源服务。4.3.2 接口接入接口应支持 RESTful 或 WebService 接口形式。 RESTful 服务消息封装协议应采用IETF RFC 1945超文本传输协议 1. 0或IETF RFC 2616 超文本传输协议 1. 1,WebService 服务消息封装协议应采用W3C 简单对象访问协议 1. 1或W3C
12、简单对象访问协议 1. 2。接口接入信息应包含:a) 接口访问地址。b) 接口参数:包括参数中文名、参数英文名、参数类型。c) 接口编码:UTF-8 或者 GBK。d) 接口描述。4.3.3 认证接口4.3.3.1 接口信息认证接口信息应包含:a) 服务地址:https:/ / IP 地址:端口。b) 接口路径:/ oauth/ token。c) 接口类型:RESTful 或 WebService。d) 接口请求方式:POST。e) 接口编码:UTF-8。f) 内容类型:application/ x-www-form-urlencoded。4.3.3.2 输入参数认证接口输入参数应符合表 1
13、的规定。表 1 认证接口输入参数序号参 数 名 称参 数 代 码参 数 类 型非 空备 注1用户名usernameString是 登录账户2密码passwordString是 登录密码3身份标识client_idString是 用户接口调用唯一身份标识4加密信息client_secretString是 身份标识加密信息5认证方式grant_typeString是 接口调用认证方式 client_cre-dentials 或 password 或 CA 证书,默 认 client _ credentials。 使 用password 模式需要传入用户名及密码,client_credentials
14、 时无需传入用户名密码6权限范围scopeString是 read 或 write,默认值 read3JT/ T 1415.320224.3.3.3 返回参数认证接口返回参数应符合表 2 的规定。表 2 认证接口返回参数序号参 数 名 称参 数 代 码参 数 类 型非 空备 注1身份令牌access_tokenString是2令牌类型token_typeString是 默认值 Bearer3过期时间expires_inString是 从调用认证接口获得身份令牌开始计时,在该时段内响应的身份令牌有效,单位为秒4.3.4 业务接口4.3.4.1 接口信息业务接口信息应包含:a) 服务地址:http
15、s:/ / IP 地址:端口。b) 接口路径:/ manage/ service。c) 接口类型:RESTful 或 WebService。d) 接口请求方式:POST。e) 接口编码方式:UTF-8。f) 内容编码类型(Content-Type):application/ json。4.3.4.2 输入参数业务接口输入参数应符合表 3 的规定。表 3 业务接口输入参数序号参 数 名 称参 数 代 码参 数 类 型非 空备 注1资源服务标识sidString是 资源服务接口唯一标识2业务参数编码dataCodeString是 资源服务接口调用时的业务参数3业务参数数值dataValueStri
16、ng是 业务参数的输入值4逻辑符号operationString是 描述业务参数与数据之间的关系,如等于、大于、小于等4.3.4.3 返回参数业务接口返回参数应符合表 4 的规定。表 4 业务接口返回参数序号参 数 名 称参 数 代 码参 数 类 型非 空备 注1调用状态标识stateCodeString是 资源服务接口调用状态标识2错误描述信息errorDescriptionString 错误信息,调用成功则为空3业务参数数值dataJSON 业务数据返回值4JT/ T 1415.320224.3.4.4 状态码调用业务接口时,通过状态码判定接口调用情况,业务接口状态码应符合表 5 的规定。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- JTT 1415.3-2022 交通运输数据资源交换与共享 第3部分:数据格式与接口 JT 1415.3 2022 交通运输 数据 资源 交换 共享 部分 数据格式 接口
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【wen****ei】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【wen****ei】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。