说明: 以下接口需对请求数据进行加密,对响应数据进行解密。加密方式见文末
身份认证申请接口
请求协议:http
请求方式:post
请求url:https://open.digitalcitizen.com.cn:7280/idauth/validateIdentity/apply/{authMode}
url参数:
| 参数名 | 说明 |
| --- | --- |
| authMode | 认证模式(详见文末) |
请求头部:
| 标签 | 内容 |
| --- | --- |
| Content-Type | application/json |
| Authorization | 鉴权接口中获取到的token |
| appId | 应用id |
请求参数:
| 参数名 | 说明 | 必填 | 类型 |
| --- | --- | --- | --- |
| deviceId | 设备id | 否 | string |
返回参数:
| 参数名 | 说明 | 必填 | 类型 |
| --- | --- | --- | --- |
| code | 响应码 | 是 | string |
| msg | 响应信息 | 是 | string |
| bizSerialNum | 业务流水号 | 是 | string |
| randNum | 随机数 | 是 | string |
响应示例:
{
"code": "0",
"msg": "响应成功",
"data": {
"bizSerialNum": "49C825540937201000",
"randNum": "ODY3NUZFOTk2RkIzMjQwMgAPMEUCIH66w6xQhR9xMxLBIEEwDQ/l28veIMXG2UnGyjkqx1ENAiEAoZxtlYLqoSePDpiRVuBm2H5pydnOtX6ysiwUw9ygTVo="
}
}
---
身份认证请求接口
请求协议:http
请求方式:post
请求url:https://open.digitalcitizen.com.cn:7280/idauth/validateIdentity/request/{authMode}
url参数:
| 参数名 | 说明 |
| --- | --- |
| authMode | 认证模式(详见文末) |
请求头部:
| 标签 | 内容 |
| --- | --- |
| Content-Type | application/json |
| Authorization | 鉴权接口中获取到的token |
| appId | 应用id |
请求参数:
| 参数名 | 说明 | 必填 | 类型 | 示例 |
| --- | --- | --- | --- | --- |
| bizSerialNum | 业务流水号 | 是 | string |
| photoData | 照片数据(base64编码) | 否 | string |
| name | 姓名 | 否 | string |
| number | 身份证号码 | 否 | string |
| validDateStart | 有效期起始日期 | 否 | string | 20150211 |
| validDateEnd | 有效期截止日期 | 否 | string | 20250211 |
返回参数:
| 参数名 | 说明 | 必填 | 类型 |
| --- | --- | --- | --- |
| code | 响应码 | 是 | string |
| msg | 响应信息 | 是 | string |
| authResult | 认证结果 | 是 | string |
成功响应示例:
{
"code": "0",
"msg": "响应成功",
"data": {
"authResult": "0XXX"
}
}
失败响应示例:
{
"code": "5XXX",
"msg": "身份信息未查到"
}
认证模式:
| 模式代码 | 模式内容 |
| --- | --- |
|0X0F| DN+人像+网证+安全策略 |
|0X4F| DN+人像+网证+安全策略+2项信息 |
|0X1F| DN+人像+网证+安全策略+4项信息 |
|0X13| DN+人像+4项信息 |
|0X1D| DN+网证+安全策略+4项信息 |
|0X06| 人像+网证 |
|0X16| 人像+网证+4项信息 |
|0X10| 4项信息 |
|0X12| 人像+ 4项信息 |
|0X40| 2项信息 |
|0X42| 人像+2项信息 |
|0X62| 人像+2项信息+第三方人像 |
|0X32| 人像+4项信息+第三方人像 |
数据加密方式说明
服务端接口采用json格式传输,数据用AES128 CBC模式加密,填充方式为PKCS5Padding,初始向量"NLPtech-ctid-NLP”。AES密钥请参考管理系统的机构应用信息章节,参数设置详见示例代码。
- CTID身份认证服务能力接入文档
- 身份认证服务介绍
- 身份认证能力介绍
- 名词解释
- 产品定价
- 计费说明
- 接入集成介绍
- API接口列表
- 鉴权接口
- 身份认证接口
- 集成示例
- 集成示例总图
- 客户端加密方式接入示例
- 安卓客户端示例
- IOS客户端示例
- Java服务端示例
- PHP服务端示例
- 服务端加密接入方式示例
- Java服务端加密示例
- PHP服务端加密示例
- 管理系统介绍
- 登录
- 机构应用信息
- 身份验证日志
- 常见问题
- 客户端加密接入方式FAQ
- Android端FAQ
- IOS端FAQ
- JAVA服务端FAQ
- PHP服务端FAQ
- 服务端加密接入方式FAQ
- JAVA服务端加密FAQ
- PHP服务端加密FAQ
- 平台FAQ
- 服务端常见异常
- 资料下载
- 客户端加密接入方式DEMO源码
- 服务端加密接入方式DEMO源码