ICS 35.240.01 CCS L 71 备案号 LD 中华人民共和国 劳动和劳动安全 行业标准 LD/T 6004—2023 人力资源社会保障信息系统服务接口报文 体规范 Specification s of message body style for service interface of human resources and social security information system 2023 - 11 - 24发布 2023 - 12 - 01实施 中华人民共和国人力资源和社会保障部 发布 LD/T 6004 —2023 I 目次 前言 ................................ ................................ ................. II 1 范围 ................................ ................................ ............... 1 2 规范性引用文件 ................................ ................................ ..... 1 3 术语和定义 ................................ ................................ ......... 1 4 缩略语 ................................ ................................ ............. 1 5 接口类型 ................................ ................................ ........... 1 6 报文类型 ................................ ................................ ........... 2 7 报文结构 ................................ ................................ ........... 2 8 查询接口 ................................ ................................ ........... 2 请求报文体规范 ................................ ................................ . 2 响应报文体规范 ................................ ................................ . 3 9 操作接口 ................................ ................................ ........... 5 请求报文体规范 ................................ ................................ . 5 响应报文体规范 ................................ ................................ . 7 10 接口说明文档 ................................ ................................ ...... 8 11 报文体加密 ................................ ................................ ........ 9 12 其他要求 ................................ ................................ .......... 9 版本控制 ................................ ................................ ...... 9 指标代码 ................................ ................................ ...... 9 附录A（资料性） 接口说明文档示例 ................................ .................... 10 A.1 返回结果为单条记录接口说明文档示例 ................................ ............ 10 A.2 返回结果为多条记录接口说明文档示例 ................................ ............ 13 参考文献 ................................ ................................ ............. 17 LD/T 6004 —2023 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由 人力资源社会保障部 提出并归口。 本文件起草单位： 人力资源社会保障部信息中心 。 本文件主要起草人： 许莹莹、蒋旭卉、赵劲、马丹蕾、张加会、汪诚、李凯、李晨星、马艳婷、黄 振宇、徐梓川、刘渊、李静 。 LD/T 6004 —2023 1 人力资源社会保障信息系统服务接口报文体规范 1 范围 本文件规定了人力资源社会保障信息系统服务接口报文体的推荐性设计要求，包括服务接口的技 术选型、报文类型、报文结构、报文体格式规范、接口说明文 档、报文体加密和其他要求。 本文件适用于人力资源社会保障信息系统设计开发数据交换和业务协同服务接口 。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 39786 —2021 信息安全技术 信息系统密码应用基本要求 LD/T 02.2 —2022 人力资源社会保障电子认证体系规范 第2部分：电子认证系统技术规范 LD/T 92—2013 社会保险管理信息系统指标集与代码 3 术语和定义 下列术语和定义适用于本文件。 服务接口 service interface 业务系统（或基础支撑平台）为其他使用方提供数据交换的一种方式，是由一系列功能封装后可被 信息系统用户直接远程调用的软件接口 。 报文 message 服务接口传输的数据单元，封装了业务数据记录和通讯控制信息。 报文体 message body 报文的主体部分，包含一条或多条业务数据记录。 4 缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议（ Hypertext Tran sfer Protocol ） JSON：JavaScript 对象简谱，是一种轻量级的数据交换格式（ JavaScript Object Notation ） REST：表述性状态传递（ Representational State Transfer ） SSL：安全套接层（ Secure Socket Layer ） UTF-8：8比特万国码的可变长度字符编码（ 8-bit Unicode Transformation Format ） 5 接口类型 人力资源社会保障信息系统的服务接口从功能上主要分为以下类型： a) 查询接口：可根据查询条件返回数据响应结果的服务接口； b) 操作接口：可对业务数据资源进行单条增加、批量增加、修改与删除操作的服务接口。 服务接口宜采用 RESTful（HTTP+JSON ）协议，并借助 SSL证书加密传输。 注： RESTful是一种网络应用程序的设计风格和开发方式，本文件中指符合“ REST+JSON ”格式的服务接口架构。 LD/T 6004 —2023 2 6 报文类型 人力资源社会保障信息系统的服务接口，其接口报文应采用 UTF-8作为字符编码，应使用 JSON格式 作为输入输出标准， 报文数据通常分为“对象”“数组”“对象 +数组”三种类型 。 7 报文结构 接口报文由报文头和报文体两部分组成，报文头由信息系统（或基础支撑平台）自行定义，报文体 参照本规范定义。 8 查询接口 请求报文体规范 8.1.1 报文体内容 查询接口的请求报文体为查询条件信息。 根据查询条件信息的数据类型不同，可分为“对象”“数组”两种格式 。 8.1.2 格式要求 查询接口的请求报文体格式要求如下： a) 字段名采用字符