电子合同API开发文档 v5

企业账户创建

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

请求方式:POST

参数位置:body

权限控制:不支持

接口版本: 5.0.2 5.1.6 5.2.3

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

接口描述:
1)对接方调用本接口在一定签平台中创建企业机构账号,后续有关该机构的所有操作都需使用该机构的org_id。系统将根据提供的机构证件信息申请数字证书。
2)创建账户的同时会生成一个默认的机构印章,默认印章可通过查询机构印章接口查到
3)创建账户前请先完成对签署机构的实名认证,可单独调用实名认证API服务,也可以采用其他第三方身份认证服务。(如果采用第三方身份认证服务务必妥善保存身份认证的过程信息,以便日后举证)
4)一个个人用户可以创建多个机构
5)需要联系商务开通此功能

请求参数

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

参数名 是否必填 长度 类型 默认值 描述 示范
easy_id 18 STRING -
所属个人,创建个人用户后返回的id
175976105528922112
id_number 128 STRING -
机构证件号
913****
id_type 2 STRING -
机构证件类型
1
name 128 STRING -
机构名称,机构名称不能重复
上海寻xxx科技有限公司
open_id 36 STRING -
所属个人,创建个人用户后返回的open_id
2c6084c0-ad71-11ea-9664-0242ac320a0c
org_legal_id_number 128 STRING -
机构法人证件号
1110000****
org_legal_name 128 STRING -
机构法人名称
粟**
process - STRING -
是否使用一定签提供的h5实名认证流程,如果使用id_type、id_number、org_legal_name, org_legal_id_number 参数可不传递, 如果使用输入1,不使用请留空或输入-1
-1

请求示范

 POST https://api.1dq.com/v5/Accounts/createOrg.json
 {
    "easy_id": "175976105528922112",
    "id_number": "913****",
    "id_type": "1",
    "name": "上海寻xxx科技有限公司",
    "org_legal_id_number": "1110000****",
    "org_legal_name": "粟**",
    "process": "-1"
}

返回结果

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

----org_id

- STRING 机构的Id,请妥善保管此org_id 后续所有该机构的操作均需要该Id

----easy_id

- STRING 机构的easy_id,请妥善保管此easy_id 后续所有该机构的操作均需要该Id

----seal_id

- STRING 企业印章id,如果未实名认证,该id为空

成功示范

{
    "code": 200,
    "msg": "success",
    "data": {
        "org_id": "c97394f4-370b-11eb-9422-0242ac110004",
        "seal_id": "c9adafae-370b-11eb-89f5-0242ac110004",
        "easy_id": "175984800321114112"
    }
}

失败示范

{
    "code": 404,
    "msg": "机构名称已经存在",
    "data": []
}

状态码

状态码 说明 备注
200 success -

其他备注

暂无

附件一 接口示范代码