LD/T 6002-2023 人力资源社会保障政务服务平台接入转接技术规范

ICS35.240.01

CCSL78

备案号92459-2024

LD

中华人民共和国劳动和劳动安全行业标准

LD/T6002—2023

人力资源社会保障政务服务平台接入转接

技术规范

Technicalspecificationsforaccessandtransferofhumanresourcesandsocial

securitygovernmentserviceplatform

2023-11-24发布2023-12-01实施

中华人民共和国人力资源和社会保障部发布

LD/T6002—2023

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5通讯协议1

6报文结构1

7接口类型2

8接口接入要求2

查询接口2

操作接口5

接口说明文档8

接口管理要求8

9接口调用要求8

调用流程8

获取令牌9

服务调用9

10加密标准10

附录A（资料性）人社政务服务平台结果码（code）代码表11

A.1人社政务服务平台结果码（code）代码表11

附录B（资料性）人社政务服务平台接口说明文档示例12

B.1返回结果为单条记录12

B.2返回结果为多条记录13

参考文献15

I

LD/T6002—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由人力资源社会保障部提出并归口。

本文件起草单位：人力资源社会保障部信息中心。

本文件主要起草人：李凯、李晨星、赵劲、马艳婷、张加会、汪诚、蒋旭卉、许莹莹、罗震、王静、

唐淑静、徐亚涛、超人。

II

LD/T6002—2023

人力资源社会保障政务服务平台接入转接技术规范

1范围

本文件规定了人力资源社会保障政务服务平台(以下简称人社政务服务平台)的接入转接技术要求，

包括人社政务服务平台的通讯协议、报文结构、接口类型、接口接入、接口调用、加密标准等内容。

本文件适用于人力资源社会保障各类信息系统以及通过服务接口方式与人社政务服务平台对接的

信息系统设计开发。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T39786—2021信息安全技术信息系统密码应用基本要求

LD/T02.2—2022人力资源社会保障电子认证体系规范第2部分：电子认证系统技术规范

LD/T92—2013社会保险管理信息系统指标集与代码

LD/T6004—2023人力资源社会保障信息系统服务接口报文体规范

3术语和定义

LD/T6004界定的术语和定义适用于本文件。

服务接口serviceinterface

业务系统（或基础支撑平台）为其他使用方提供数据交换的一种方式，是由一系列功能封装后可被

信息系统用户直接远程调用的软件接口。

[来源：LD/T6004—2023，3.1]

报文message

服务接口传输的数据单元，封装了业务数据记录和通讯控制信息。

[来源：LD/T6004—2023，3.2]

4缩略语

下列缩略语适用于本文件。

HTTP：超文本传输协议（HypertextTransferProtocol）

HTTPS：超文本传输安全协议（HypertextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript对象简谱，是一种轻量级的数据交换格式（JavaScriptObjectNotation）

REST：表述性状态传递（RepresentationalStateTransfer）

UTF-8：8比特万国码的可变长度字符编码（8-bitUnicodeTransformationFormat）

5通讯协议

人力资源社会保障政务服务平台服务接口遵循HTTPS协议，采用RESTful（HTTP+JSON）协议，字符

编码为UTF-8，报文为JSON格式。通过互联网接入人社政务服务平台的服务，报文宜加密处理。

注：RESTful是一种网络应用程序的设计风格和开发方式，本文件中指符合“REST+JSON”格式的服务接口架构。

6报文结构

1

LD/T6002—2023

人社政务服务平台服务接口报文由报文头和报文体两部分组成，报文头须遵循本文件要求，报文体

按照LD/T6004—2023的规范定义。

7接口类型

人社政务服务平台的服务接口从功能上可分为查询接口（queryinterface）和操作接口(operation

interface)。

注1：查询接口是可根据查询条件返回数据响应结果的服务接口。

注2：操作接口是可对业务数据资源进行单条增加、批量增加、修改与删除操作的服务接口。

8接口接入要求

查询接口

8.1.1请求报文规范

报文内容

查询接口的请求报文为查询条件信息。

根据查询条件信息的数据类型不同，可分为“对象”“数组”两种格式。

格式要求

查询接口的请求报文格式要求如下：

a)字段名采用字符串格式，业务数据字段参照《人力资源社会保障管理信息系统信息结构通则》

的规则使用小写字母和数字顺序号命名，其他数据字段使用英文首词字母小写的小驼峰命名

法（lowerCamelCase）命名；

b)如果查询业务场景为分页查询，查询参数中需要传入分页参数，统一采用“cpage”表示当前

页码（从1开始），“rows”表示每页数量；

c)如果查询条件为数组，统一采用“totalCount”表示查询对象总数，“list”用于存放查询条

件的数组“[]”，数组中可以放置多个JSON对象。

报文格式

.1对象类型普通查询

普通查询是指输入查询条件，获取查询结果数据。如社会保障卡状态查询，查询条件包含社会保障

号码、姓名，请求报文格式见示例。

示例：

{

"aac002":"4401011********236",

"aac003":"张*"

}

注1：aac002为查询条件“社会保障号码”。

注2：aac003为查询条件“姓名”。

.2对象类型分页查询

分页查询是指除查询条件外，还需要将查询页码、每页记录数量等信息一同提交。如养老保险缴费

情况查询，查询条件为社会保障号码、姓名，请求报文格式见示例。

示例：

{

"aac002":"4401011********236",

"aac003":"张*",

"cpage":1,

"rows":10

2

LD/T6002—2023

}

注1：cpage为当前页码。

注2：rows为每页数量。

.3数组类型批量查询

数组类型查询条件使用较少，一般在一次性查询多条记录时使用，对于数组类查询条件，需要标记

查询对象数量，将查询条件存放在list中。如一次性查询多人社会保障卡状态，查询条件包含社会保障

号码、姓名，请求报文格式见示例。

示例：

{

"totalCount":2,

"list":[

{

"aac002":"4401011********236",

"aac003":"张*"

},

{

"aac002":"4352311********364",

"aac003":"李*"

}

]

}

注1：totalCount为查询对象总条数。

注2：list用于存放查询条件的数组“[]”，数组中可以放置多个JSON对象。

8.1.2响应报文规范

报文内容

查询接口的响应报文为查询结果信息。

响应报文的报文内容包含返回码、接口调用结果描述、数据等内容。

根据响应报文数据类型不同，可分为“对象”“数组”“对象+数组”三种格式。

格式要求

查询接口的响应报文格式要求如下：

a)字段名采用字符串格式，业务数据字段参照《人力资源社会保障管理信息系统信息结构通则》

的规则使用小写字母和数字顺序号命名，其他数据字段使用英文首词字母小写的小驼峰命名

法（lowerCamelCase）命名；

b)如果返回结果为分页，返回参数中需要包含分页参数，统一采用“totalPage”表示分页查询

最大页数；

c)如果返回结果为数组，统一采用“totalCount”表示返回对象总数，“list”用于存放返回结

果的数组“[]”，数组中可以放置多个JSON对象；

d)“code”字段为返回码，返回码的代码值和代码名称见附录A；

e)“busiStatus”字段由服务提供方自定义，对本次请求的业务处理结果以“代码”方式进行说

明；

f)“message”字段由服务提供方自定义，存放接口调用的相关描述，对本次请求的业务处理结

果以“文字”方式进行说明；

g)“data”字段存放接口返回的数据。

报文格式

.1对象类型

3

LD/T6002—2023

普通查询一般返回一个对象数据，即一个JSON对象，返回结果可以放置在对象中。响应报文格式见

示例。

示例：

{

"code":"00",

"busiStatus":"001",

"message":"成功",

"data":{

"aac002":"4401011********236",

"aac003":"张*",

"aac004":"1",

"aac004desc":"男",

"aac011":"21",

"aac011desc":"大学本科",

"……":"……"

}

}

注1：code字段为返回码，返回码见附录A。

注2：busiStatus字段由服务提供方自定义，对本次请求的业务处理结果以“代码”方式进行说明。

注3：message字段由服务提供方自定义，存放接口调用的相关描述，对本次请求的业务处理结果以“文字”方式进

行说明。

注4：data字段存放接口返回的数据。

注5：aac004desc字段放置代码类型的中文释义，采用LD/T92—2013。

注6：aac011desc字段放置代码类型的中文释义，采用LD/T92—2013。

.2数组类型

分页查询、批量查询通常返回多个对象数据，需要标记返回对象数量、分页参数，将返回结果存放

在list中。响应报文格式见示例。

示例：

{

"code":"00",

"busiStatus":"001",

"message":"成功",

"data":{

"totalCount":2,

"totalPage":10,

"list":[

{

"aac002":"4401011********236",

"aac003":"张*",

"aab004":"北京市**公司",

"aac019":"2",

"aae030":"2010年03月26日",

"aae031":"2013年03月25日"

},

{

"aac002":"4352311********364",

"aac003":"李*",