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

获取参与方操作链接(签署链接)

POST
/api/getContractOperateUrl
V1.2.0V1.4.0
提示
合同参与方(签署方/发起方) 可以使用此接口进行 签署/操作
1.该链接仅1次有效,可重复获取
2.合同发起审批未通过时,签署人无法获取链接
3.如未有相关权限会先跳转到个人/企业授权页
需要权限:
get_psn_sign_task_info:授权允许获取个人用户的签署任务
或
get_corp_sign_task_info: 授权允许获取企业的签署任务

请求头格式#

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

请求参数

Body 参数application/json
psnOperatorInfo
object  | null 
个人参与方信息
必需
个人参与方传此值,与企业参与方二选一
psnAccount
string  | null 
个人手机号
必需
psnAccount与openPsnId二选一
openPsnId
string  | null 
个人授权账号ID
必需
psnAccount与openPsnId二选一
corpOperatorInfo
object  | null 
企业参与方信息
必需
企业参与方传此值,与个人参与方二选一
corpName
string  | null 
企业参与方名称
必需
corpName与openCorpId二选一
openCorpId
string  | null 
企业参与方授权帐号ID
必需
corpName与openCorpId二选一
staffInfo
object 
企业员工信息
必需
参与方企业员工信息
contractId
string 
合同ID
必需
clientType
string 
客户端类型
必需
指定客户端类型, h5-移动端适配 pc-电脑端适配
示例
{
  "corpOperatorInfo": {
    "corpName": "郑州客客科技有限公司",
    "staffInfo": {
      "psnAccount": "15267777150"
    }
  },
  "contractId": "8785",
  "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 'api.pre-qiandun365.com/api/getContractOperateUrl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpOperatorInfo": {
        "corpName": "郑州客客科技有限公司",
        "staffInfo": {
            "psnAccount": "15267777150"
        }
    },
    "contractId": "8785",
    "clientType": "pc"
}'

返回响应

🟢200成功
application/json
Body
code
string 
返回码
必需
msg
string 
返回码描述
必需
result
object  | null 
结果
必需
operateUrl
string 
操作链接
必需
success
boolean 
是否成功
必需
ts
string 
时间戳
必需
logKey
string 
日志key
必需
示例
{
  "result": {
    "operateUrl": "https://saas-pc.pre-qiandun365.com/signManage?contractId=3084&temporaryToken=G5AfWrEc"
  },
  "code": "200",
  "msg": "成功",
  "logKey": "02cea512",
  "ts": "1691482581753",
  "success": true
}
修改于 2025-01-21 05:55:53
上一页
发起合同
下一页
催办合同签署
Built with