接口地址: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 | 注册成功 | - |
暂无