交通运输物流公共信息平台内嵌页面系统接口规范.PDF

交通运输物流公共信息平台 内嵌页面系统接口规范 第1 章：范围 本规范规定了交通运输物流公共信息平台 （以下简称“平台”“内嵌页面系统”通用的 接口规范、接口的数据参数、返回结果以及接口规范中涉及的数据格式。“内嵌页面系统” 接口包括交换积压接口、企业登录接口、内嵌页面调用其他应用服务 （包括平台信用中心、 跟踪中心等）接口和通知公告类接口、行业监测中心接口等。 本规范适用于为 “内嵌页面系统”对外的接口规范（包含其他系统调用内嵌页面系统的 接口规范和部分内嵌页面调用其他系统的接口规范），提供调用接口的系统、内嵌页面系统、 需要调用“内嵌页面系统”接口的其他系统的设计与开发应用： 第2 章：规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适 用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 JT/T 919.1—2014 交通运输物流信息交换 第1 部分：数据元 第3 章：概述 内嵌页面系统是物流企业用户和各应用中心的枢纽和桥梁，其中统一认证是管理中心、 内嵌页面、各应用中心的枢纽和桥梁。内嵌页面属于管理中心内部应用系统，整个用户、内 嵌页面、各应用中心的身份认证和身份识别都是基于统一认证的基础上进行的。 内嵌页面系统主要用于物流软件的集成应用，相关网站的内嵌集成。丰富其软件和网站 的内容，统一标准，提高用户对平台的认识。 内嵌页面系统与物流软件、各个应用系统以及管理中心都是依靠相对应的接口联系对应 起来的。本文档主要对各接口作相应的规范约束。本文档的接口规范说明，包含了物流软件 登录内嵌页面接口（简称企业登录接口）、内嵌页面调用其他应用服务接口、通知公告类接 口、行业监测中心接口（指内嵌页面首页显示的相关行业中心基本提醒的接口）。 物流软件、内嵌页面系统、管理中心、应用服务系统以及统一认证相关的关系如下图所 示： 企业用户 软件用户名、软件密码 2、申请企业令牌 物流软件 （物流交换代码、密码） 3、企业令牌、物流交换代码、软件用户名 认证中心 4、验证企业令牌 内嵌页面 5、企业服务列表 管理中心 6、查询企业开通的服务哪些有内嵌服务 7、申请内嵌令牌 内嵌服务 （内嵌用户名、密码、服务ＩＤ） 8、内嵌页面令牌、用户名、企业令牌、物流交换代码、软件用户名 9、验证内嵌令牌 应用中心 应用返回页面 第4 章：交换积压接口 1．接口功能 交换积压接口是“内嵌页面系统”向“交换中心”调用的一个接口。主要功能是通过企 业的交换代码获取该企业在平台“交换中心”中积压的数据情况，包括未发送和未接收的积 压数据条数。该接口由“平台交换系统”提供；由“内嵌页面系统”调用。该接口以 URL 直接访问方式提供。交换中心接收到请求后返回查询企业（物流交换代码）的最新交换积压 数（包含发送积压数和接受积压数）统计值。 2. 接口采用 该接口由“平台交换系统”提供；由“内嵌页面系统”调用。 该接口以URL 直接访问方式提供。 请 求 方 式 为 URL 的 请 求 方 式 ， 请 求 的 地 址 为：../../changeOverstock.htm?logisticsExchangeCode=XXXXXX 说明： （1）XXXXXX 为需要查询的企业物流交换代码。 （2 ）请求的URL 地址中，“.htm”可以为“.jsp”、“.html”或者其他后缀。 3. 参数说明 交换积压接口返回结果数据格式其格式说明如下： 表1 交换积压接口返回结果数据格式