获取拖章定位页面

POST

/contract/seal/position/url

获取拖章定位页面，需要配合回调“OPEN_GET_SEAL_POSITION（获取拖章定位）”使用

注意

回调接入详见回调接入文档

请求参数

Body 参数application/json

businessCode

string

第三方业务码

可选

不大于64个字符

fileCode

string

文件代码

必需

上传文件或基于模板创建文件接口获取

signerRoles

array[string]

角色列表

必需

<= 10 items

clientType

enum<string>

指定客户端类型

必需

枚举值:

pch5

redirectUrl

string

重定向地址

可选

expirationTime

integer

链接有效期

可选

单位：秒

>= 1

示例

{
    "businessCode": "TEST_BUSINESS_CODE_001",
    "fileCode": "FC_20250317093729IoBAmkyfKQoEHyy",
    "signerRoles": [
        "测试123",
        "测试567"
    ],
    "clientType": "pc",
    "redirectUrl": "https://www.baidu.com",
    "expirationTime": 3600
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'api.pre-qiandun365.com/api/contract/seal/position/url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessCode": "TEST_BUSINESS_CODE_001",
    "fileCode": "FC_20250317093729IoBAmkyfKQoEHyy",
    "signerRoles": [
        "测试123",
        "测试567"
    ],
    "clientType": "pc",
    "redirectUrl": "https://www.baidu.com",
    "expirationTime": 3600
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

result

object

必需

getSealPositionUrl

string

页面地址

必需

serviceId

string

业务id

必需

logKey

string

必需

number

必需

success

boolean

必需

示例

{
    "result": {
        "getSealPositionUrl": "https://saas-pc.pre-qiandun365.com/openApi/tool/sealPosition?channel=open-service&temporaryToken=DGXUaEVg&serviceId=2506179UATBJ2F1V&appId=293",
        "serviceId": "2506179UATBJ2F1V"
    },
    "code": "200",
    "msg": "成功",
    "logKey": "3ef462c3",
    "ts": "1750147076501",
    "success": true
}

修改于 2025-06-20 10:07:28

获取拖章定位

通过文件发起合同