签盾开放平台-公有云版
  1. 企业认证&授权
签盾开放平台-公有云版
  • 快速入手
    • 接入流程
    • 业务流程
  • 帮助文档
    • 基本概念
    • 合同状态说明
    • 印章指定位置
    • 静默签使用说明
    • 常见错误码
    • 回调接入文档
  • 开发前必读
    • 公共请求格式
    • 移动端(Android,IOS,微信小程序,H5)--接入
  • 认证授权
    • 用户认证&授权流程
    • 个人认证&授权
      • 获取个人认证&授权链接
      • 查询个人认证信息
      • 查询个人授权信息
    • 企业认证&授权
      • 获取企业认证&授权链接
        POST
      • 查询企业认证信息
        GET
      • 查询企业授权信息
        GET
  • 合同签署
    • 文件处理
      • 本地文件上传
        • 上传合同文件
        • 上传合同附件
      • 模版文件使用
        • 基于模板创建合同文件
      • 获取文件关键字坐标
    • 合同发起
      • 发起合同
    • 合同操作
      • 获取参与方操作链接(签署链接)
      • 催办合同签署
      • 撤回合同
    • 合同查询
      • 查询企业合同类目
      • 获取合同预览链接
      • 查询合同详情
      • 分页查询合同列表
      • 查询合同存证信息
      • 下载合同文件及合同附件
  • 审批管理
    • 审批流程使用场景
    • 列表查询用户可用的审批流程
      GET
    • 分页查询审批状态合同列表
      POST
    • 查询签署用印审批详情
      GET
    • 查询发起合同审批详情
      GET
    • 获取审批操作链接
      POST
  • 企业管理
    • 企业信息查询
    • 分页查询员工
    • 新增员工
    • 删除员工
  • 印章管理
    • 分页查询个人印章列表
    • 分页查询企业印章列表
    • 查询个人印章详情
    • 查询企业印章详情
    • 获取印章静默签授权链接
  • 回调通知
    • 回调接入文档
    • 接口测试
    • 获取回调信息
    • 回调成功确认
    • 回调成功确认(新)
  • 开放接口
    • 企业四要素校验
    • 企业三要素校验
    • 身份证OCR识别
    • 营业执照OCR识别
    • 身份二要素校验
    • 银行卡二要素
    • 银行卡三要素
    • 银行卡四要素
    • 个人二要素诉讼信息
    • 个人运营商三要素
    • 企业工商四要素
  1. 企业认证&授权

获取企业认证&授权链接

测试中
POST
/api/corpAuthUrl
用于获取企业的认证授权页面链接,通过此链接企业用户可进行个人实名认证、资源授权等操作。
注意
用户授权有效期默认永久有效(100年)。
新注册企业需要等工商信息更新后(预计1周)方可使用,
可以调用【查询企业授权信息】获取企业授权有效期和授权范围
可以调用【查询企业认证信息】查询企业的认证状态和个人openCorpId

企业认证方式2种(corpIdentMethod)#

legalRep - 法人认证:营业执照+法人人脸OCR
agent - 授权人(经办人)认证:营业执照+企业银行打款+经办人授权书

设置页面中可选择的个人授权范围#

get_corp_ident_info - 授权允许获取企业身份信息
get_corp_seal_info - 授权允许获取企业的印章相关资源
get_corp_organization - 授权允许获取企业的组织数据
get_corp_template - 授权允许获取企业的模板数据
corp_sign_task_init - 授权允许代表企业发起合同
get_corp_sign_task_info - 授权允许获取企业的合同信息
get_corp_sign_task_file - 授权允许获取企业的合同文件

请求头格式#

具体请求头参数,请查看公共请求格式

请求参数

Body 参数application/json

示例
{
    "corpAuthConfig": {
        "openCorpId": null,
        "corpName": "赋能通(浙江)科技有限公司",
        "corpIDCardType": "CRED_ORG_USCC",
        "corpIDCardNum": "91330109MA2H2CM85U",
        "legalRepName": "李志东",
        "transactorInfo": {
            "psnAccount": "135XXXXXXXX",
            "psnName": "李志东",
            "psnIDCardType": "CRED_PSN_CH_IDCARD",
            "psnIDCardNum": "330325XXXXXXXXXXXX",
            "psnMobile": "135XXXXXXXX",
            "psnAuthModes": "mobile"
        }
    },
    "corpIdentMethod": "legalRep",
    "pageConfig": {
        "corpEditableFields": [
            "corpName","legalRepName"
        ],
        "transactorEditableFields": [
            "psnName","psnIDCardNum"
        ]
    },
    "authorizeConfig": {
        "authorizedScopes": [
            "get_corp_sign_task_info"
        ]
    },
    "redirectConfig": {
        "redirectUrl": "http://ivd.vg/shgbx",
        "redirectDelayTime": 3
    },
    "clientType": "pc"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.pre-qiandun365.com/api/corpAuthUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpAuthConfig": {
        "openCorpId": null,
        "corpName": "赋能通(浙江)科技有限公司",
        "corpIDCardType": "CRED_ORG_USCC",
        "corpIDCardNum": "91330109MA2H2CM85U",
        "legalRepName": "李志东",
        "transactorInfo": {
            "psnAccount": "135XXXXXXXX",
            "psnName": "李志东",
            "psnIDCardType": "CRED_PSN_CH_IDCARD",
            "psnIDCardNum": "330325XXXXXXXXXXXX",
            "psnMobile": "135XXXXXXXX",
            "psnAuthModes": "mobile"
        }
    },
    "corpIdentMethod": "legalRep",
    "pageConfig": {
        "corpEditableFields": [
            "corpName","legalRepName"
        ],
        "transactorEditableFields": [
            "psnName","psnIDCardNum"
        ]
    },
    "authorizeConfig": {
        "authorizedScopes": [
            "get_corp_sign_task_info"
        ]
    },
    "redirectConfig": {
        "redirectUrl": "http://ivd.vg/shgbx",
        "redirectDelayTime": 3
    },
    "clientType": "pc"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "result": {
        "authUrl": "https://saas-pc.pre-qiandun365.com/third/authorization?code=8ktuy2zht1pgqw6y3toj&appId=90",
        "authFlowId": "100003438",
        "authCode": "8ktuy2zht1pgqw6y3toj"
    },
    "code": "200",
    "msg": "成功",
    "logKey": "95f19937",
    "ts": "1711425120623",
    "success": true
}
修改于 2025-02-06 01:36:51
上一页
查询个人授权信息
下一页
查询企业认证信息
Built with