說明: 以下接口需對請求數據進行加密,對響應數據進行解密。加密方式見文末
身份認證申請接口
請求協議: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源碼