获取合同签署链接（页面）

POST

/open/contract/sign/url

V1.3.0

注意

通过此接口获取签署链接进行页面签署，若发起合同时未指定签署位置，则所有合同文件都必须进行落章

可能出现的错误码

错误码	错误信息	解决办法
500	服务繁忙,请重试.	联系客服
400	参数错误.	参数与接口文档进行核对
oc_40005	签署记录不存在或状态异常	检查签署人状态
oc_40006	合同不存在或状态异常	检查合同状态

请求参数

Body 参数application/json

accountId

string

签署方accountId

必需

contractId

number

合同id

必需

clientType

enum<string>

指定客户端类型

必需

枚举值:

pch5

expirationTime

integer

链接有效期

可选

单位：秒，默认15天

>= 1

示例

{
    "accountId": "TEST_20250514_xxy_001",
    "contractId": 1920368226253934600,
    "clientType": "pc",
    "expirationTime": 3600
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'api.pre-qiandun365.com/api/open/contract/sign/url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": "TEST_20250514_xxy_001",
    "contractId": 1920368226253934600,
    "clientType": "pc",
    "expirationTime": 3600
}'

返回响应

🟢200成功

application/json

Body

code

string

请求返回code

必需

msg

string

请求返回msg

必需

result

object

必需

operateUrl

string

签署链接

必需

success

boolean

是否成功

必需

logKey

string

必需

string

必需

示例

{
    "code": "string",
    "msg": "string",
    "result": {
        "operateUrl": "string"
    },
    "success": true,
    "logKey": "string",
    "ts": "string"
}

合同查询

无感签署（申请开放）