通过上传创建合同

最近更新时间:2020-07-13 08:25:35

1. 接口描述

接口请求域名: ds.tencentcloudapi.com 。

此接口适用于:客户平台通过上传PDF文件作为合同,以备未来进行签署。接口返回任务号,可调用DescribeTaskStatus接口查看任务执行结果。

默认接口请求频率限制:1000次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateContractByUpload。
Version String 公共参数,本接口取值:2018-05-23。
Region String 公共参数,本接口不需要传递此参数。
Module String 模块名ContractMng
Operation String 操作名CreateContractByUpload
SignInfos.N Array of SignInfo 签署人信息
ContractFile String 合同上传链接地址
ContractName String 合同名称
Remarks String 备注
Initiator String 合同发起方腾讯云帐号ID(由平台自动填写)
ExpireTime String 合同长时间未签署的过期时间

3. 输出参数

参数名称 类型 描述
TaskId Integer 任务ID
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 上传合同并新增

上传合同并新增

输入示例

https://ds.tencentcloudapi.com/?Action=CreateContractByUpload
&Module=ContractMng
&Operation=CreateContractByUpload
&ContractFile=https://cloud.tencent.com/
&ContractName=test
&Remarks=test
&Initiator=dcu-c33uil4ap6
&SignInfos.0.AccountResId=dcu-c33uil4ap6
&<公共请求参数>

输出示例

{
  "Response": {
    "RequestId": "1cf1946c-5fb1-4eaa-8fdf-49ba755fd798",
    "TaskId": 1
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.AuthorizationTimeError 授权时间格式错误。
FailedOperation.CreateContractError 合同创建失败。
FailedOperation.DescribeSubplatError 获取子平台信息失败。
FailedOperation.IPFormatError 授权IP地址格式错误。
FailedOperation.Other 其它。
InternalError.UnknownError 内部错误。
MissingParameter.ContractFileNameError 合同名称不能为空。
MissingParameter.ContractFilePathError 合同文件路径不能为空。
MissingParameter.LocationNullError 授权IP地址不能为空。
MissingParameter.MOError 找不到 module 或 operation。
MissingParameter.SignerNullError 签署人不能为空。
ResourceNotFound.AccountNotFound 账户不存在或已删除。
ResourceNotFound.InitiatorNotFoundError 合同发起方账号不存在。
ResourceNotFound.SubplatIdNotFound 子平台ID不存在。
ResourceUnavailable.ContractSignerUnavailable 合同签署人不存在或状态异常,不能进行合同创建操作。
目录