跳到主要内容

BSN实名DID接口

创建DID身份

接口说明:创建DID身份

请求方式:POST

请求路径:/bsn-did/account/create

请求业务参数:

参数名参数类型是否必填参数说明
idCardstring身份证号码
realNamestring真实姓名

返回业务参数:

参数名参数类型参数说明
ctidstring身份ID
publicKeystringSM2公钥
publicKeyIndexinteger公钥索引

搜索DID身份

接口说明:搜索DID身份

请求方式:POST

请求路径:/bsn-did/account/search

请求业务参数:

参数名参数类型是否必填参数说明
idCardstring身份证号码
realNamestring真实姓名
publicKeyIndexinteger公钥索引

返回业务参数:

参数名参数类型参数说明
ctidstring身份ID
publicKeystringSM2公钥

DID身份详情

接口说明:DID身份详情

请求方式:POST

请求路径: /bsn-did/account/detail

请求业务参数:

参数名参数类型是否必填参数说明
ctidstring身份ID

返回业务参数:

参数名参数类型参数说明
ctidDocumentStringstring身份DID JSON字符串
statusinteger身份DID状态(0,1)

创建DID身份证明

接口说明: 创建DID身份证明

请求方式:POST

请求路径:/bsn-did/account/credential/create

请求业务参数:

参数名参数类型是否必填参数说明
idCardstring身份证号码
realNamestring真实姓名

返回业务参数:

参数名参数类型参数说明
txHashstring交易哈希
dataEncstring加密数据

验证DID身份证明

接口说明: 验证DID身份证明

请求方式:POST

请求路径:/bsn-did/account/credential/verify

请求业务参数:

参数名参数类型是否必填参数说明
txIdstring交易哈希
dataEncstring加密数据

返回业务参数:

参数名参数类型参数说明
comparisonFlagboolean验证是否成功
publicKeystring安信平台公钥

创建DID文档

接口说明: 创建DID文档

请求方式:POST

请求路径:/bsn-did/document/create

请求业务参数:

参数名参数类型是否必填参数说明
ctidstring身份ID
publicKeyIndexstring公钥索引
attributesobject业务属性

返回业务参数:

参数名参数类型参数说明
didstringDID文档ID
ctidDidstring身份ID
bsnSignatureValuestringBSN签名值
attributesobject业务属性键值对
versionstring版本号
createdstring创建时间
updatedstring更新时间
authenticationobject认证公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
recoverobject恢复公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
proofobject证明信息
├ createrstring创建者
├ typestring证明算法类型
┕ signatureValuestring证明签名

DID文档详情

接口说明: DID文档详情

请求方式:POST

请求路径:/bsn-did/document/detail

请求业务参数:

参数名参数类型是否必填参数说明
didstringDID文档ID

返回业务参数:

参数名参数类型参数说明
didstringDID文档ID
ctidDidstring身份ID
bsnSignatureValuestringBSN签名值
attributesobject业务属性键值对
versionstring版本号
createdstring创建时间
updatedstring更新时间
authenticationobject认证公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
recoverobject恢复公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
proofobject证明信息
├ createrstring创建者
├ typestring证明算法类型
┕ signatureValuestring证明签名

验证DID文档

接口说明: 验证DID文档

请求方式:POST

请求路径:/bsn-did/document/verify

请求业务参数:

参数名参数类型是否必填参数说明
didstringDID文档ID
ctidDidstring身份ID
bsnSignatureValuestringBSN签名值
attributesobject业务属性键值对
versionstring版本号
createdstring创建时间
updatedstring更新时间
authenticationobject认证公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
recoverobject恢复公钥信息
├ publicKeystring公钥
┕ typestring公钥算法类型
proofobject证明信息
├ createrstring创建者
├ typestring证明算法类型
┕ signatureValuestring证明签名

返回业务参数:

参数名参数类型参数说明
verifiedboolean是否通过验证

更新DID文档

接口说明: 更新DID文档

请求方式:POST

请求路径:/bsn-did/document/update

请求业务参数:

参数名参数类型是否必填参数说明
didstringDID文档ID
ctidDidstring身份ID
attributesobject更新后的业务属性

返回业务参数:

参数名参数类型参数说明
verifiedboolean是否通过验证

删除DID文档

接口说明: 删除DID文档

请求方式:POST

请求路径:/bsn-did/document/delete

请求业务参数:

参数名参数类型是否必填参数说明
didstringDID文档ID

返回业务参数:

参数名参数类型参数说明
txIdstring交易哈希