按坐标签署合同

最近更新时间:2019-07-24 15:18:05

1. 接口描述

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

此接口适用于:客户平台在创建好合同后,由合同签署方对创建的合同内容进行确认,无误后再进行签署。客户平台使用该接口提供详细的PDF文档签名坐标进行签署。

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

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:SignContractByCoordinate
Version String 公共参数,本接口取值:2018-05-23
Region String 公共参数,本接口不需要传递此参数。
Module String 模块名ContractMng
Operation String 操作名SignContractByCoordinate
ContractResId String 合同ID
AccountResId String 帐户ID
AuthorizationTime String 授权时间,格式为年月日时分秒,例20160801095509
Position String 授权IP地址
SignLocations.N Array of SignLocation 签署坐标,坐标原点在文件左下角,坐标单位为磅,坐标不得超过合同文件边界
SealResId String 印章ID
CertType Integer 选用证书类型:1 表示RSA证书, 2 表示国密证书, 参数不传时默认为1
ImageData String 签名图片,base64编码

3. 输出参数

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

4. 示例

示例1 按坐标签署合同

按坐标签署合同

输入示例

https://ds.tencentcloudapi.com/?Action=SignContractByCoordinate
&Module=ContractMng
&Operation=SignContractByCoordinate
&ContractResId=dcc-480rzey2gw
&AccountResId=dcu-c33uil3apq
&AuthorizationTime=20180531142255
&Position=10.0.0.238&SealResId=dcs-c654e84rqw
&SignLocations.0.SignOnPage=1
&SignLocations.0.SignLocationLBX=50
&SignLocations.0.SignLocationLBY=140
&SignLocations.0.SignLocationRUX=110
&SignLocations.0.SignLocationRUY=200
&<公共请求参数>

输出示例

{
  "Response": {
    "RequestId": "c2dfb7d4-4d3a-4e3b-81eb-516bc06c29e6"
  }
}

5. 开发者资源

API Explorer

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

SDK

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

命令行工具

6. 错误码

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

错误码 描述
FailedOperation.ContractExpired 合同已过期。
FailedOperation.CoordinateOutsidePDF 坐标值超出PDF尺寸范围。
FailedOperation.DescribeSubplatError 获取子平台信息失败。
FailedOperation.GetPDFSizeFailed 获得PDF页面尺寸失败。
FailedOperation.ImageNotBase 图片数据应为BASE64编码格式。
FailedOperation.MessageDataOverSize 报文数据长度过长。
FailedOperation.NoPermissionToSign 用户没有开通代签权限。
FailedOperation.RepeatedCoordinate 签名域对角坐标值不能重复。
FailedOperation.SealMismatched 印章不匹配。
FailedOperation.WrongCertType 证书类型为不支持的类型。
ResourceNotFound.SubplatIdNotFound 子平台ID不存在。