注册账户与证书 - 科创链·ScienceChain

用户注册接口功能：用户的统一身份注册与应用身份区分。
注册参数包括应用平台身份验证信息、用户信息、其他可选注册参数等。
平台身份验证信息确保操作为平台进行，防止利用接口随意注册别人信息，包括平台名称、id、证书名、私钥等。
用户信息包括用户名、邮箱和手机号等，邮箱和手机号必须填写一个，用于生成唯一id。
可选参数用来实现忘记私钥、加密注册、选择id生成源、判断是否为新区块链用户等。
用户注册涉及到的流程如下图所示。

注册流程

需注意以下几点：
1）如不想暴露id中的敏感信息，可以使用encryptionMethod参数，对邮箱或手机号加密后注册id。
2）当不需要返回pks时，pwd建议设置为空。
3）同一个人Id加密前后生成id视作不同链上用户,邮箱和手机号生成id视作不同链上用户

请求参数

Body 参数application/json

platform

string

必需

平台或机构名称（需已加入）

superAdmin

boolean

可选

超管注册平台账号模式，默认为false

platformCreditCode

string

平台Id

必需

platformCertName

string

平台账户证书名

必需

platformPriPem

string

平台私钥

必需

string

邮箱

必需

mobile

string

手机号

必需

pwd

string

PKS加密密码

可选

idByPhone

boolean

可选

是否由手机号生成Id，当为false时由邮箱生成，默认值为false

encryptionMethod

string

可选

加密方法名：如不想暴露id中的敏感信息，传入加密方法名，对邮箱或手机号加密后注册id，目前支持的方法有md5

forceGenCert

boolean

可选

当证书存在时，但对应密码忘记了，强制注册新的证书密钥对，默认为false。

onlyFirst

boolean

可选

仅首次上链才进行注册，适用于想使用新的id进行交易，默认为false。

示例

{
    "platform": "cs",
    "superAdmin": false,
    "platformCreditCode": "identity-net:csAdmin",
    "platformCertName": "cs",
    "platformPriPem": "",

    "email": "cs008@qq.com",
    "mobile": "13600001111",

    "pwd": "",
    "idByPhone": false,
    "encryptionMethod": "",
    "forceGenCert": false,
    "onlyFirst": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

result

object

可选

示例

初次注册且成功身份证书已存在设置了仅首次注册账户才进行证书注册

{
    "code": 0,
    "msg": "注册成功",
    "result": {
        "txId": "a44f7833-018c-4bb4-82f3-8d201ff57fbd",
        "uuid": {
            "idSource": "email",
            "value": "cs008@qq.com",
            "EncryptionMethod": "",
            "creditCode": "identity-net:cs008@qq.com"
        },
        "name": "cs008@qq.com",
        "mobile": "13600001111",
        "certName": "cs",
        "certFullName": "identity-net:cs008@qq.com.cs",
        "usrAlias": "cs008@qq.com_cs",
        "certPem": "-----BEGIN CERTIFICATE-----\r\nMIIBJTCBzKADAgECAgYBjg1lX/QwCgYIKoZIzj0EAwIwGjEYMBYGA1UEAwwPY3Mw\r\nMDhAcXEuY29tX2NzMB4XDTI0MDMwNTA2NTUzMVoXDTI5MDMwNDA2NTUzMVowGjEY\r\nMBYGA1UEAwwPY3MwMDhAcXEuY29tX2NzMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcD\r\nQgAEc7cr/LKI3w+lG+Lz/nmYsS3X3KpFwpLB5ezSsjvDKG5XmPGgVJEIVGG2VVNz\r\nrdpQ6tg0jPgJs11U00IwJq8xijAKBggqhkjOPQQDAgNIADBFAiAWlRQi22scR3Ci\r\n24r9bnmpFIDGKBOtjVdYTJ4iMIGuzwIhAOCD14SBEA+gMUZDKHr6orQ6JnrLfDtx\r\nSJVq19PsJTnX\r\n-----END CERTIFICATE-----\r\n",
        "priKeyInfo": {
            "priPem": "-----BEGIN PRIVATE KEY-----\r\nMIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgOfVkl6v65oP2Pies\r\ndnVaisb4dh3bA1ibLdeHODJs8dWgCgYIKoZIzj0DAQehRANCAARztyv8sojfD6Ub\r\n4vP+eZixLdfcqkXCksHl7NKyO8MobleY8aBUkQhUYbZVU3Ot2lDq2DSM+AmzXVTT\r\nQjAmrzGK\r\n-----END PRIVATE KEY-----\r\n"
        }
    }
}