电子合同API开发文档 v5

个人账户创建

接口地址:https://api.1dq.com/v5/Accounts/create.json

请求方式:POST

参数位置:body

权限控制:支持

接口版本: v5.0

在线工具:API在线调试接口

接口描述:
1)对接方调用本接口在一定签平台中创建个人账号,后续有关该用户的所有操作都需使用该用户的easy_id。(如提供用户证件信息,则将根据提供的用户证件信息申请数字证书。如未提供,则用户认证成功后申请数字证书)
2)如提供用户证件信息,创建账户的同时会生成一个默认的个人印章,默认印章可通过查询个人印章接口查到;
3) 如提供用户证件信息,创建账户前请先完成对签署用户的实名认证,可单独调用实名认证API服务,也可以采用其他第三方身份认证服务。(如果采用第三方身份认证服务务必妥善保存身份认证的过程信息,以便日后举证。)
4) 创建的用户可通过 注销个人账户 来删除,如果是测试环境可以通过 清除所有测试账户 接口来删除
5) 手机号为必填,其他选填,手机号作为用户唯一标识,不能重复

请求参数

除去下列参数中,需要在header中添加公共参数,详见公共请求参数

参数名 是否必填 长度 类型 默认值 描述 示范
number - STRING -
手机号
18111111111
id_number - STRING -
证件号
110111****
id_type - INT -
证件类型, 1为身份证/ 2为港澳通行证 / 3为台胞证 / 4为护照 / 5为其他
1
name - STRING -
姓名
张三
process - STRING -1
是否使用一定签提供的h5实名认证流程,如果使用则输入1,参数name、id_type、id_number 参数可不传递,不使用为空或-1
-1

请求示范

 POST https://api.1dq.com/v5/Accounts/create.json
 {
    "id_number": "110111****",
    "id_type": "1",
    "name": "张三",
    "number": "18111111111",
    "process": "-1"
}

返回结果

参数名 是否必填 长度 类型 默认值 描述 示范
code 1-10 long 业务状态码 200
msg 2-64 string 结果描述 请求成功
data - 结果集 -

----open_id

36 STRING 请保存此open_id,后续有关该用户的所有操作都需使用 d3bd91aa-a3ed-11ea-814b-0242ac110003

----easy_id

- STRING 请保存此id,后续有关该用户的所有操作都需使用

----seal_id

- STRING 印章id,如果您的用户未实名,该参数不会返回

成功示范

{
    "code": 200,
    "msg": "success",
    "data": {
        "open_id": "086c4cc6-3632-11eb-98b0-0242ac110004",
        "seal_id": "08f1f54c-3632-11eb-b029-0242ac110004",
        "easy_id": "175592531139104768"
    }
}

失败示范

{
    "code": 404,
    "msg": "证件号不能为空"
}

状态码

状态码 说明 备注
200 注册成功 -

其他备注

暂无

附件一 接口示范代码