工会网上工作平台应用系统接入申请表、接口格式示例

时间:2022-07-03 16:45:06 浏览量:

 附 录 A (资料性)

 应用系统接入申请表 应用系统接入申请表见表A.1。

 表A.1 应用系统接入申请表 申请单位名称

 地址

 联系人

 电话

 手机

 邮箱

 接入需求 应用系统名称:

 接入目的:

 集成功能描述:(如有数据对接,需明确对接哪些数据)

  备注:需集成功能模块由 XX 市总工会/企业工会负责。

 申请单位意见

 负责人(签字):

 XX 市总工会/企业工会(盖章)

 年

  月

  日 回复意见 经评估,同意/不同意上述应用系统的接入。

 省总工会网络办(盖章)

 年

  月

  日

 A

 B

 附 录 B (资料性)

 接口格式示例 B.1 交换格式 格式包括但不限于JSON、XML、HTML、CVS、EXCEL等,格式说明见表B.1。

 表B.1 交换格式示例 格式类型 格式说明 格式使用 适用场景 JSON a.数据在名值对(name/value pairs)中; b.数据由逗号分隔; c.大括号保存对象; d.中括号保存数组。

 a.读取 JSON 字符串; b.用 eval()或者 parse()处理字符串。

 需重用数据时,优先使用 JSON。

 XML a.声明:定义 XML 文件版本以及字符集; b.根标签:树形结构的根节点; c.子元素:相对上一级而言,可以自定义,必须有结束标签,对大小写敏感; d.属性:一个元素可以拥有多个名字不同的属性。

 a.读取 XML 文档;

 b.使用 XML DOM 循环遍历文档;

 c.读取值并存储与变量。

 HTML 由普通文本组成无需解析;可读性高。

 用标记符<HTML>表示文件的开头,</HTML>则表示该文件的结尾。

 CSV 使用表格和分隔符来表示数据的格式,以纯文本形式存储表格数据(数字和文本)。

 由任意数目记录组成,记录间以某种换行符分隔;每条记录由字段组成,字段间的分隔符是其它字符或字符串,最常见的是逗号或制表符。。

 EXCEL 其数据模板和数据文件样式基本一致。

 每个 Sheet 存放一个交换内容,一个数据文件可以存放多个交换内容。

 B.2 服务接口格式 B.2.1 类型要求 请求与响应格式及对应的内容类型要求见表B.2。

 表B.2 内容类型对照关系 格式类型 格式内容 对应的 Content-Type 值 备注 请求格式 字符串格式 application/x-www-form-urlencoded

 JSON 格式 application/json

 格式类型 格式内容 对应的 Content-Type 值 备注 响应格式 JSON 格式 application/json

 HTML 格式 text/html 适用于文件上传接口 JSONP 格式 application/x-javascript 适用于跨系统调用 API B.2.2 请求格式

 B.2.2.1 请求参数 应支持GET或POST方式提交请求数据。

 请求参数示例见表B.3。

 表B.3 请求参数 参数名 位置 类型 必填 说明 公共参数 authorization Header String 是 工会网上工作平台为应用系统分配的接入授权号。例 如 :

 Bearer d668ed88-a353-4566-a1f3-2b246b1613cb1 业务参数 memberId Body String 否 会员 Id

 …… …… …… …… 更多参数 B.2.2.2 签名规则 请 求 业 务 参 数 按 照 序 号 顺 序 , 使 用 URL 键 值 对 的 格 式 ( 即memberId=value1&laborCode=value2)拼接成字符串stringA,在stringA最后拼接上密钥得到stringSignTemp字符串,并对stringSignTemp进行MD5运算得到签名字符串。

 B.2.3 响应格式 响应参数示例见表B.4。

 表B.4 响应参数 参数名 类型 必填 中文名 描述 公共参数 code String 是 返回状态代码 0:成功 1:重复参与 2:不在所属区域内 3:请求参数错误 4:其他错误 msg String 是 返回状态描述

 data String 是 返回结果数据集

 业务参数 laborName String 否 工会名称 示例参数 …… …… …… …… 更多参数

  响应示例见表B.5。

 表B.5 响应示例 {

  "code": "0",

  "msg": "操作成功",

  "total": -1,

  "data": {

  "laborId": "O0000000000000000001",

  "laborCode": "370000000000",

  "laborName": "XXX工会",

  "legalPerson": "XXX",

  } }

相关热词搜索: 申请表 示例 接入