江西省可信身份认证系统对接规范

江西省可信身份认证系统

对接规范

2020年10月

修订历史记录

日期版本说明作者

<2020-07><1.0>初始版本〈廖金彪＞

<2020-09><1.1>修改4.1.2章节〈廖金彪＞

<2020-09><1.2>修改3.1.1章节v廖金彪＞

<2020-10><1.3>修改4.2章节内容〈廖金彪＞

<2020-10><1,4>修改第5章节内容〈廖金彪＞

目录

1.简介5

1.1.定义、首字母缩写词和缩略语5

1.2.安全规范6

1.2.1数据接口权限6

1.2.2敏感信息展示6

1.2.3签名规则6

1.2.4数据加密7

2.应用接入流程8

2.1.接入流程8

2.2.应用申请9

2.3.应用审核9

2.4.开发及联调9

2.5.应用上线9

2.6.运营维护9

3.开发指引10

3.1、注册场景10

3.1.1s个人用户注册10

3.1.2、法人用户注册10

3.2、登录10

3.2.1.获取个人用户信息10

3.2.2,获取企业详细信息10

3.3、用户认证11

3.3.1.个人认证11

3.3.2.法人认证11

4,接口规范11

4.1s个人服务接口定义11

4.1.1手机号判重接口11

4.1.2短信验证码发送接口12

4.1.3手机号短信校验接口13

4.1.4个人身份证判重接口14

4.1.5手机号+验证码注册接口15

4.1.6个人身份证找回接口16

4.1.7根据令牌获取个人用户详细信息17

4.1.8实名等级变更接口20

4.1.9简项信息比对接口21

4.1.10人脸比对接口22

4.1.11复合信息比对接口24

4.1.12出入境证件实名核验接口26

4.2、法人服务接口定义28

4.2.1绑定企业接口（个人升级法人）28

4.2.2修改企业信息接口29

4.2.3获取法人令牌接口（个人令牌换法人令牌）30

4.2.4查询企业详情接口31

4.2.5查询企业列表接口33

4.2.6法人解绑企业接口34

4.2.7添加授权帐号（个人绑定企业成为管理员或者经办人）35

4.2.8修改授权帐号37

4.2.9删除授权帐号38

4.2.10查询企业用户39

4.2.11解除授权40

4.2.12企业法人/管理员认证接口41

4.2.13查询企业详情（企业空间）42

4.2.14法人实名核验接口44

5单点登录48

5.1s单点接入48

5.1.1.接入范围48

5.1.2、单点流程48

5.1.3.自建系统对接49

5.1.4、接口调用说明52

5.2、接口定义52

521、通过统一登录页面获取票据52

522、通过票据获取令牌53

523、根据令牌获取后台用户详细信息55

5.2.4、根据令牌获取个人用户详细信息56

525、根据令牌获取法人用户详细信息59

526、根据令牌获取法人企业详细信息61

527、根据令牌获取第三方接口资源票据63

528、通过刷新令牌获取令牌64

529、注销接口66

5210、统一帐号管理页面66

6性能67

7附录错误味定义书签。

7.1.对接申请表67

7.2.MD5加解密DEMO67

7.3.AES加解密DEMO68

7.4.公共返回码68

7.5.实名核验等级71

L简介

本文档定义了江西省可信身份认证系统的接口规范和标准以及对接方案，旨在给第三方

实现接口开发提供参考。

1.1.定义、首字母缩写词和缩略语

>单点登录(SingleSignOn):简称为SSO,接入JIS的多个应用系统中，用户只需

要登录一次就可以访问所有相互信任的应用系统。

>票据picket)：票据用于江西省可信身份认证系统单点登录到第三方应用时，统一

发放给第三方应用为授权凭证信息，用于系统间的授权互信，第三方应用可以通过

校验该凭证获得授权令牌(token),票据只能使用一次且具有时效性。

>令牌(token):安全认证信息。令牌用于第三方应用进行票据认证成功后获取的安

全认证信息，第三方应用可以通过该安全认证信息获取用户的基础信息。令牌可以

多次使用且具有时效性(默认为2小时)，第三方应用需要及时刷新令牌以保证及时

获取用户。

>应用标识(appmark):应用的身份唯一标识。应用标识为江西省可信身份认证系统

分配给第三方的应用的唯一标识，第三方应用系统在调用江西省可信身份认证系统

接口时，应用标识作为参数传入。

>应用密钥(appword)：应用密钥为江西省可信身份认证系统分配给第三方的应用的

安全钥匙，在第三方应用系统调用江西省可信身份认证系统接口服务时，应用标

识、应用密钥和当前时间戳按照顺序拼接进行MD5加密作为参数传入。

>代理接入资源应用标识(proxyapp):已经单点登录的业务系统请求江西省可信身份

认证系统的获取第三方资源票据接口生成票据作为参数传入，实现刷新令牌或让目

标系统进行单点登录的目的。

>SM2：是国家密码管理局于2010年12月17日发布的椭圆曲线公钥密码算法，是

一种非对称加密算法，公钥加密数据，由私钥解密。

>AES:AdvancedEncryptionStandard,高级对称加密算法；

>MD5:Message-DgestAlgorithm5（信息-摘要算法），安全加密算法。

>BASE64：用于传输8Bit字节码的编码方式之一，是一种基于64个可打印字符又表

示二进制数据的方法。

1.2.安全规范

1.2.1数据接口权限

接入系统默认没有权限获取用户敏感信息，如需要获取敏感信息。

敏感信息如下：

公民身份号码、姓名、手机号、固定电话号码、邮箱、家庭住址等等。

1.2.2敏感信息展示

在web前端内容中出现用户个人敏感信息时，应按照规范进行部分隐藏。具体的前端

内容包括但不限于：

■前端Web页面（含h5页面）的所有敏感信息。

■Javascript脚本

■URL地址

缺省信息隐藏规则：

证件号码前台展示规范：前1位和后1位，其它用*号代替，如"3*****************4”；

手机号：显示前3和后4位,其它用上代替，如“183****7492”

邮箱：显示前两位和符号前一位开始至末尾的所有字符，其余用*代替。如

M18*********（§）M

姓名：姓使用*代替，如"*三"

1.2.3签名规则

江西省可信身份认证系统为每个应用分配应用标识（appmark）和应用密钥（appword）,

应用标识为应用身份的唯一标识，应用密钥为调用江西省可信身份认证系统接口服务时的钥

匙，在调用时需将两者拼接并加上时间戳，对时间进行签名。

签名算法：MD5（appmark+appword+time）,将应用标识、应用密钥、发送时间按顺

序连接并进行md5加密。

签名认证的参数：

名称说明是否必填数据类型长度（字节）

appmark接入应用在可信身份认

是String

证系统注册成功后的应

用标识，由【管理员】提

供。

time时间戳，当前时间

年月日时分秒

例：2009年10月10日是String

12时12分12秒格式为

12

signMD5(appmark+

appword+timc),将应用

标识、应用密钥、发送时

间按顺序连接并进行

md5加密。注:1、参数

是String

appmsrk、appword由

【管理员】提供；

2、MD5加密方法是32位

的原生加密方法；

3、time是时间戳

1.2.4数据加密

江西省可信身份认证系统对数据在传输的过程中进行加密传输，加密方式根据传输的具

体情况分为两种：

(1)由第三方系统向江西省可信身份认证系统传输数据时，可通过AES加密方式，

对敏感信息进行加密传输；

由江西省可信身份认证系统向第三方系统传输数据时，可通过SM2加密方式，对敏感

信息进行加密传输.

2,应用接入流程

2.1.接入流程

提51

*

获取《口防需妾的

I___遗传加密故后和客户少

接

口

调

用

阶

段

2.2.应用申请

申请单位首先需要向江西省信息中心提出申请，填写《江西省可信身份认证系统接入申

请表》和《江西省可信身份认证系统接入承诺函》（见附录7.1）,申请成功之后由承建单位

开发对接负责人进行提供以下信息：

2.3.应用审核

申请单位应用申请提供相关应用信息之后，江西省可信身份认证系统应用管理员将对提

供的资料进行审核，审核通过之后为申请应用提供以下相关材料：

appmark,appword,uuid,privatekey,分别为应用标识，应用密钥（作为签名和

AES数据加密使用），应用UUID,数据私钥（SM2解密速用）。

2、相关API和SDK等。

3、调试地址。

2.4.开发及联调

申请单位按照江西省可信身份认证系统提供的API进行系统改造，申请单位按照自己对

接的功能选择相对应的接口进行开发，具体参照本文档接口规范。

2.5.应用上线

申请单位的应用在联调环境中完成系统功能测试后，可以申请在正式环境上线“此时需

要江西省可信身份认证系统应用管理员在正式环境上架应用并提供信息（例如：正式的接口

地址）给申请单位，申请单位修改对接地址及参数，并完成上线后的基本功能测试。

2.6.运营维护

上线完成后，需要江西省可信身份认证系统的运维商与申请单位的承建开发商共同完成

运营维护的工作。双方详细记录接口调用日志，方便业务异常时问题定位。

3.开发指引

3.1、注册场景

3.1.1s个人用户注册

接口调用说明

通过手机号+短信验证码方式注册个人账号，注册成功后返回个人令牌，如果已经存在对应

的账号了，也返回个人令裨。

第一步：先调4.1.3短信验证码发送接口,发送短信验证码；

第二步:校验通过后，再调用4.L5手机号+短信验证码注册接口

3.1.2.法人用户注册

3.1.2.1.接口调用说明

第一步：扫脸认证，调用4.1.10人脸比对接口进行实人核验；

第二步：法人身份核验，调用427法人检验接口，核实当前个人是否是要绑定企业的法人；

第三步：核验通过后，调用421绑定企业接口（个人升级法人）,如果没有对应的法人账号则

生成法人账号，并添加企业绑定关系，如果有法人账号了，直接绑定企业。

3.2s登录

3.2.1.获取个人用户信息

3.2.L1.接口调用说明

第一步：先调4.L3短信验证码发送接口,发送短信；

第二步：用户输入验证码后，再调用413手机号短信校验接口,此接口会返回个人令牌；

第二步：最后再调417根据令牌获取个人用户详细信息,获取到用户详细信息。

3.2.2.获取企业详细信息

3.2.2.1.接口调用说明

第一步：个人用户登录后，获取到个人令牌（参考3.121）;

第二步：调用422获取法人令牌（个人令牌换法人令牌）接口,获取对应的法人令牌；

第三步：调用424查询企业列表接口,获取企业列表信息；

第四步：根据第三步获取到的企业id,再调用423查询企业详情接口，获取企业详细信息。

3.3X用户认证

3.3.1.个人认证

3.3.3.L接口调用说明

江西省可信身份认证系统的用户实名检验等级分5级，等级信息参考7.5实名核验等级。

笫一步：实名认证，调用4.1.9实名认证接口；实人认证，调用4.L10人脸比对接口；

第二步：认证等级只能提升不能降低，提升实名认证等级调4.L8实名等级变更接口；

3.3.2.法人认证

3.3.2.L接口调用说明

验证当前用户是否为本人，并且验证当前用户是否为即将绑定的企业的法人。

第一步：调用4.1.10人脸比对接口，验证当前用户是否为本人；

第二步：第一步核验通过后，用户输入需要绑定的企业信息；

第三步：调用427法人核验接口,核验当前用户是否为绑定企业的法人。

4,接口规范

4.1s个人服务接口定义

4.1.1手机号判重接口

接口描述

该接口用于手机号认证，填写完手机号后，判断手机号是否注册个人个人用户。

请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/

标识jisapiCheckMobileReg

4.11.3请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

下

”{"mobile":“手机号

Suing必填

注意：params需要用AES加密方法进

行加密后传输。加密秘钥为appword

（即应用秘钥）

41.1.4返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

4.1.2短信验证码发送接口

4.121接口描述

该接口用于第三方服务发送短信信息

4.122接口地址

操作操作名称

方式REST

地址http:〃应用地址/jisapi/

标识jisapiSendMobileCode

4.1,2.3请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

下

“{“userType”:“l-个人，2-法人，0-后台

用户:mobile":“手机号》

注意：params需要用AES加密方法（加String必填

密方法参照AES加密接口,见3212,

JAVA语言开发的可以参照附录5.4）进

行加密后传输。加密秘钥为appword

（即应用秘钥）

返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

4.1.3手机号短信校验接口

接口描述

该接口用于校验手机号短信是否正确

请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/

标识jisapiCheckMobileCode

4.1,3.3请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

String必填

下

“{“userType":"l-个人,2-法人,0-后台

用户”,

"loginName":"用户名（法人场景必填）

II

9

“mobile":“手机号二

“mobileCode"：”手机短信验证

码‘}"

注意：params需要用AES加密方法进

行加密后传输5加密秘钥为appword

（即应用秘钥）

返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

datadata参数详情

data参数

参数名中文描述

refreshtoken刷新令牌，有对应账号的时候返回

token令牌，有对应账号的时候返回

4.1.4个人身份证判重接口

4.141接口描述

该接口用于判断身份证是否被抢注，适用于APP手机号注册场景。

请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/che

标识checkpapersnumberreg

4.1,4.3请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

下

"{"papersNumber":"证件号码》

Suing必填

注意：params需要用AES加密方法进

行加密后传输。加密秘钥为appword

（即应用秘钥）

41.4.4返回参数

4.1.4.5参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

data返回参数，证件没被占用返回空字符串

data参数

参数名中文描述

flagflag二1标识证件被占用

loginName证件被占用账号的登录名

mobile证件被占用账号的手机号

4.1.5手机号+验证码注册接口

4.151接口描述

该接口配合4.1.2接口一起使用，即根据手机号+短信验证码注册个人账号，如果账号存在,

则返回令牌。

4.152接口地址

操作操作名称

方式REST

地址https://应用地址/jisapi/

标识jisapimobileCodeRegister

41.5.3请求地址

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

下

“{“useiType":"l-个人,2-法人（目前只

能注册个人账号，不支持法人）：

"mobile":"手机号”，

MmobileCode":"手机短信验证

String必填

码”}“

注意：params需要用AES加密方法（力口

密方法参照AES加密接口,见3212,

JAVA语言开发的可以参照附录5.4）进

行加密后传输c加密秘钥为appword

（即应用秘钥）

4.154返回参数

4.1.5.5参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

datadata参数详情

data参数

参数名中文描述

refreshtoken刷新令牌，有对应账号的时候返回

token令牌，有对应账号的时候返回

4.1.6个人身份证找回接口

接口描述

该接口用于个人注册，身份证被其他人抢注测场景，调Jis接口，删除之前关联账号的姓名、

身份证号，并锁定账号。

4.1,6.2请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/

标识jisapiFindPapersNumber

请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式°数据固定格式如

下

"{"papersNumber":"证件号

码"}“

注意：params需要用AES加密方法（力口String必填

密方法参照AES加密接口,见3212,

JAVA语言开发的可以参照附录5.4）进

行加密后传输“加密秘钥为appword

（即应用秘钥）

4.1,6.4返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

4.1.7根据令牌获取个人用户详细信息

接口描述

该接口是实现第三方系统使用令牌获取个人用户的详细信息。

4.1,7.2请求地址

操作操作名称

方式REST

地址https:〃应用地址/sso/

4.1,7.3请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

time时间戳，即当前时间String必填

格式为：年月日时分秒

实例：

2015年05月10日12时12分12秒

格式应写为202

sign参数内容为：

MD5（appmark+appword+time）

即将应用标识、应用密钥、当前时间按

顺序连接并进行md5加密。

注：1、参数appmark、appwcrd由【管

理员】提供；

2、MD5加密方法是32位的原生加密String必填

方法；（只支持小写形式，具体可见附

录）

3、AES加密方式（具体课件附录）。

4、time是时间戳

servicename业务名称

String必填

（固定值：findOutsideUserByToken）

params业务参数，json格式。数据固定格式如

下

"（String必填

"token":"令牌”

）"

返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

data返回的用户详细数据，经过SM2/AES/RSA加密，解密后的数据详

见data包含的元素说明（解密私钥由江西省可信身份认证系统管

理员提供；如接口调用失败，该参数不显示，解密方式请查看附

录）

data包含的元素说明

是否必要，默认只返回

参数名中文描述uuid,loginname,其他信息如果需

要，可在接入申请表中申请。

uuid用户唯一ID默认返回

loginname用户登录名默认返回

name用户姓名（已实名的用户，姓名需申请

才具有真实性）

code用户编码默认返回S

证件类型（默认为1）

1身吩证

3港澳通行证；圭

paperstype而芟ctt]甲C±3由

4台湾通行证

5外籍人士永久居留证

papersnumber证件号码需要申请

mobile手机号码需申请

email电子邮箱需申请

isauthuser是否实名：1-已实名未实名需申请

authlevel实名等级：0：_未认证，1-初级；需申请

2.中级；3-高级；

nation民族，见国标GB3304-91需申请

regtime注册时间需申请

logintime上一次登录时间需申请

sex性别：1-男；。-女需申请

post邮编需申请

address地址需申请

nickname昵称默认返回

residence居住地默认返回

registeredresid户口所在地默认返回

ence

headportraitp头像相对地址默认返回

ath

4.1.8实名等级变更接口

4.181接口描述

实名等级只能升级，不能降级。注意：必须保证调该接口前参数是经过认证的，即数据是有

效的。

4.1,8.2请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/

请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params业务参数，json格式。数据固定格式如

下

{"token":"BDQBTXNBfl<lyQw5IBURwMH

YlAEMCRgw/BEV9RglwAUMHNwJNdk

4=","name":"张三

String必填

","papersnumber":"","paperstype":"l","l

evel":"l"}

注意：params需要用AES加密方式进

行加密后传输。加密秘钥为appword

（即应用密钥）

返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

data返回数据

data参数

参数名中文描述

sameloginname身份证被抢注的时候返回，被占用的身份证

samemobile身份证被抢注的时候返回，被占用的手机号

4.1.9简项信息比对接口

4.191接口描述

该接口为简项信息比对接口，为第三方提供身份证号与姓名进行实名认证提供能力输出。

参数已通过aes加密,加密模式为:ECB。AES加密后的byte□上封装的String是HexString,

字符集是utf-8o

注1：暂不支持港澳台人员实名认证。

注2：接口平均响应时间为300ms。。

4.1,9.2请求地址

操作操作名称

方式REST

地址ht【ps:〃应用地址/in【erfaces/identify/

请求参数

参数名中文描述类型是否必填

paramsAes加密的json字符串String必填

Json字符串内包含的参数：

参数名中文描述类型是否必填

name用户姓名String必填

idNum用户身份证号码String必填

clientCode调用方标识String必填

sm4key调用方sm4秘钥String必填

4.194返回参数

4.1.9.5参数名中文描述

result人脸校验返回码(0,其他败)

resultDetail人脸校验结果

clientCode

similarity识别率

返回实例

(1)成功响应

"result":"0",

"resultDetail":"比对成功”，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"100.0"

}

(2)失败响应

7

"result":"-1",

"resultDetail":“比对失败

}

4.1.10人脸比对接口

接口描述

人脸比对：传入用户姓名、身份证号、现场照片，后台进行比对核查。参数须通过aes

力口密，加密密钥为：WKXZilc3ble80hUm。加密模式为:ECB。AES力口密后的byte口上封装的

String是HexString,字符集是utf-8。接口会在1-2秒内返回结果，人像匹配度达到80%即

可认证成功。

注1：第三方需要用到活体检测功能时，则必须提供应用包名申请活体检测SDK包，SDK包

是根据包名进行授权。

注2：港澳人员暂不支持c

注3：如果比对的用户的信息在江西人口库中有或缓存库中有查询到数据，则不会校验身份

证有效期；如果在江西人口库中没有查询到数据，就会调用一所的接口，这时候就会校验身

份证有效期，如果身份证过期则会提示比对失败。

请求地址

操作操作名称

方式REST

地址https:〃应用地址/interfaces/identify/

请求参数

参数名中文描述类型是否必填

paramsAes加密的json字符串String必填

Json字符串内包含的参数：

参数名中文描述类型是否必填

name用户姓名String必填

idNum用户身份证号码String必填

idPhoto用户照片（base64格式）String必填

clientCode调用方标识String必填

sm4key调用方sm4秘钥String必填

返回参数

参数名中文描述

result人脸校验返回码（0,其他败）

resultDetail人脸校验结果

clientCode标识调用身份

similarity相似率

返回实例

(1)成功响应

"result":"0",

"resultDetail":"比对成功”，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"92.0"

}

(2)失败响应

"result":"-1",

"resultDetail":"比对失败

}

4.1.11复合信息比对接口

接口描述

该接口为复合信息比对接口，为第三方提供身份证号、姓名、身份证有效开始日期、身

份证有效结束日期进行四要素核验。参数已通过aes加密，加密模式为:ECB。AES加密后的

byte□上封装的String是HexString,字符集是utf-8o

请求地址

操作操作名称

方式REST

地址https://应用地址/imerfaccs/identify/aesCheckldentify.do

请求参数

参数名中文描述类型是否必填

paramsAes加密的json字符串String必填

Json字符串内包含的参数：

参数名中文描述类型是否必填

nameText姓名String必填

idNum身份证号码String必填

startTime身份证上有效期开始时间（时间格式为String非必填

yyyyMMdd）

endTime身份证上有效期截止时间（时间格式为String非必填

yyyyMMdd）

clientCode调用方标识String必填

sm4key调用方sm4秘钥String必填

返回参数

参数名中文描述

result结果码（比对结果：0-比对成功，-1-比对失败）

similarity相似度（100或-1）

clientCode客户编号（标识调用方身份,系统分配）

resultDetail错误信息描述

（1）成功响应

(

"result":"0",

"resultDetail":"比时成功'，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"180.0"

)

（2）失败响应

"result":"-1",

"resultDetall":"比对失败

)

4.1.12出入境证件实名核验接口

接口描述

此接口适用于个人实名认证，目前支持以下证件核验身份证、港澳通行证、

台湾通行证、外籍人士永久居留证

请求地址

操作操作名称

方式REST

地址https:〃应用地址/interfaces/checkldentify/

请求参数

参数名中文描述类型是否必填

params业务参数，明文参数格式为json0数据

固定格式如下

(

"paperstype":"1",

"name":"赖勇强”，

"papersnumber":

"cardstartime":o",String必填

"cardendtime":

"ndLion";"CHN"

)

注意：params需要用AES加密方式进

行加密后传输。加密秘钥为

WKXZilc3ble80hUm(即应用密钥)

params具体参数如下：

字段数据类型字段说明

namestring个人姓名

cardstartimeString证件领取时间

cardendtimeString证件到期时间

nationString国籍

证件类型（默认为1）

1身份证

3港澳通行证

paperstypeString

4台湾通行证

5外籍人士永久居留证

papersnumberstring个人证件号码

返回参数

参数名中文描述

retcode返回码（000000为成功，其他为失败，详情可见公共返回码说明）

msg返回说明

返回实例

（1）成功响应

"retcode":"000000".

“msg”:“实名成功”}

(2)失败响应

"retcode":"000001",

实名失败”

}

测试参数：

密文：

f9047a6ca483193de8960c3c1ba7a6ef63c599d13cf85847ddcda3c3a321ecfa4b592ef586bbi9b27a3fde

6464b80b219e18f4a8f1224fd564423f641393eda7b1fc520278cd94a8d34a68ed8f2414eb41fd4ec9fccdc

9b3703a04941f11349ea2fe2db3e0d919431bb12681a4c61c897deed5fd0540d7c9ea7eb092ad70ae9

明文：

(

"paperstype":"1",

"name":"赖勇强”，

"papersnumber":

"cardstartime":

"cardendtime":

"nation":"CHN"

）

4.2、法人服务接口定义

4.2.1绑定企业接口（个人升级法人）

421.1接口描述

该接口用于个人绑定企业后，创建法人账号，并添加绑定关系。

请求地址

操作操作名称

方式REST

地址https:〃应用地址/jisapi/

请求参数

参数名中文描述类型是否必填

appmark应用标识String必填

params