BSN实名DID接口
创建DID身份
接口说明:创建DID身份
请求方式:POST
请求路径:/bsn-did/account/create
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| idCard | string | 是 | 身份证号码 |
| realName | string | 是 | 真实姓名 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| ctid | string | 身份ID |
| publicKey | string | SM2公钥 |
| publicKeyIndex | integer | 公钥索引 |
搜索DID身份
接口说明:搜索DID身份
请求方式:POST
请求路径:/bsn-did/account/search
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| idCard | string | 是 | 身份证号码 |
| realName | string | 是 | 真实姓名 |
| publicKeyIndex | integer | 否 | 公钥索引 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| ctid | string | 身份ID |
| publicKey | string | SM2公钥 |
DID身份详情
接口说明:DID身份详情
请求方式:POST
请求路径: /bsn-did/account/detail
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| ctid | string | 是 | 身份ID |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| ctidDocumentString | string | 身份DID JSON字符串 |
| status | integer | 身份DID状态(0,1) |
创建DID身份证明
接口说明: 创建DID身份证明
请求方式:POST
请求路径:/bsn-did/account/credential/create
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| idCard | string | 是 | 身份证号码 |
| realName | string | 是 | 真实姓名 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| txHash | string | 交易哈希 |
| dataEnc | string | 加密数据 |
验证DID身份证明
接口说明: 验证DID身份证明
请求方式:POST
请求路径:/bsn-did/account/credential/verify
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| txId | string | 是 | 交易哈希 |
| dataEnc | string | 是 | 加密数据 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| comparisonFlag | boolean | 验证是否成功 |
| publicKey | string | 安信平台公钥 |
创建DID文档
接口说明: 创建DID文档
请求方式:POST
请求路径:/bsn-did/document/create
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| ctid | string | 是 | 身份ID |
| publicKeyIndex | string | 是 | 公钥索引 |
| attributes | object | 否 | 业务属性 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| did | string | DID文档ID |
| ctidDid | string | 身份ID |
| bsnSignatureValue | string | BSN签名值 |
| attributes | object | 业务属性键值对 |
| version | string | 版本号 |
| created | string | 创建时间 |
| updated | string | 更新时间 |
| authentication | object | 认证公钥信息 |
| ├ publicKey | string | 公钥 |
| ┕ type | string | 公钥算法类型 |
| recover | object | 恢复公钥信息 |
| ├ publicKey | string | 公钥 |
| ┕ type | string | 公钥算法类型 |
| proof | object | 证明信息 |
| ├ creater | string | 创建者 |
| ├ type | string | 证明算法类型 |
| ┕ signatureValue | string | 证明签名 |
DID文档详情
接口说明: DID文档详情
请求方式:POST
请求路径:/bsn-did/document/detail
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| did | string | 是 | DID文档ID |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| did | string | DID文档ID |
| ctidDid | string | 身份ID |
| bsnSignatureValue | string | BSN签名值 |
| attributes | object | 业务属性键值对 |
| version | string | 版本号 |
| created | string | 创建时间 |
| updated | string | 更新时间 |
| authentication | object | 认证公钥信息 |
| ├ publicKey | string | 公钥 |
| ┕ type | string | 公钥算法类型 |
| recover | object | 恢复公钥信息 |
| ├ publicKey | string | 公钥 |
| ┕ type | string | 公钥算法类型 |
| proof | object | 证明信息 |
| ├ creater | string | 创建者 |
| ├ type | string | 证明算法类型 |
| ┕ signatureValue | string | 证明签名 |
验证DID文档
接口说明: 验证DID文档
请求方式:POST
请求路径:/bsn-did/document/verify
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| did | string | 是 | DID文档ID |
| ctidDid | string | 是 | 身份ID |
| bsnSignatureValue | string | 是 | BSN签名值 |
| attributes | object | 是 | 业务属性键值对 |
| version | string | 是 | 版本号 |
| created | string | 是 | 创建时间 |
| updated | string | 是 | 更新时间 |
| authentication | object | 是 | 认证公钥信息 |
| ├ publicKey | string | 是 | 公钥 |
| ┕ type | string | 是 | 公钥算法类型 |
| recover | object | 是 | 恢复公钥信息 |
| ├ publicKey | string | 是 | 公钥 |
| ┕ type | string | 是 | 公钥算法类型 |
| proof | object | 是 | 证明信息 |
| ├ creater | string | 是 | 创建者 |
| ├ type | string | 是 | 证明算法类型 |
| ┕ signatureValue | string | 是 | 证明签名 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| verified | boolean | 是否通过验证 |
更新DID文档
接口说明: 更新DID文档
请求方式:POST
请求路径:/bsn-did/document/update
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| did | string | 是 | DID文档ID |
| ctidDid | string | 是 | 身份ID |
| attributes | object | 是 | 更新后的业务属性 |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| verified | boolean | 是否通过验证 |
删除DID文档
接口说明: 删除DID文档
请求方式:POST
请求路径:/bsn-did/document/delete
请求业务参数:
| 参数名 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| did | string | 是 | DID文档ID |
返回业务参数:
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| txId | string | 交易哈希 |