接口地址:https://api.1dq.com/v5/Accounts/createOrg.json
请求方式:POST
参数位置:body
权限控制:支持
接口版本: v5.0
在线工具:API在线调试接口
接口描述:
1)对接方调用本接口在一定签平台中创建企业机构账号,后续有关该机构的所有操作都需使用该机构的org_id。系统将根据提供的机构证件信息申请数字证书。
2)创建账户的同时会生成一个默认的机构印章,默认印章可通过查询机构印章接口查到
3)创建账户前请先完成对签署机构的实名认证,可单独调用实名认证API服务,也可以采用其他第三方身份认证服务。(如果采用第三方身份认证服务务必妥善保存身份认证的过程信息,以便日后举证)
4)一个个人用户可以创建多个机构
5)需要联系商务开通此功能
除去下列参数中,需要在header中添加公共参数,详见公共请求参数 。
参数名 | 是否必填 | 长度 | 类型 | 默认值 | 描述 | 示范 |
---|---|---|---|---|---|---|
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 | - |
暂无