文档
测试

为模板添加组件(不推荐使用)

POST
/ecs/template/addComponents.jspa

接口描述

为模板添加输入项组件,添加组件前需先上传文件

说明

==特别提醒:== 目前管理后台已支持上传模板并添加组件,本接口不再推荐使用,推荐使用后台添加的方式

请求参数

参数名
类型
描述
必填
timestamp
String
时间戳,格式为yyyy-MM-dd HH:mm:ss例如:2011-11-28 17:12:50,服务端允许客户端请求时间误差为10 分钟
必填
appKey
String
平台分配给应用的AppKey,secret也为平台分配
必填
v
String
API 协议版本,可选值:1.0
必填
nonce
String
6位数字随机数(客户端自己生成)
必填
signature
String
API 输入参数签名结果
必填
components
String
信息请求体
必填
templateNumber
String
模板id
必填
structComponent
String
必填
componentId
String
输入项组件id,使用时可用id填充,为空时表示添加,不为空时表示修改
必填
type
int
组件类型输入项组件类型,1-文本,2-数字,3-日期,6-签约区,8-多行文本,11-图片
必填
context
String
输入项组件上下文信息,包含了名称,填充格式,样式以及坐标
必填
label
String
输入项组件显示名称
必填
required
boolean
是否必填,默认true
必填
width
float
输入项组件宽度
必填
height
float
输入项组件高度
必填
font
int
默认宋体;1, "宋体 ", 2, "新宋体", 4,"黑体", 5, "楷体", 6, "微软雅黑", 7, "仿宋", 8, "华文中宋", 9, "等线";
必填
fontSize
float
填充字体大小,默认12
必填
textColor
int
默认黑色;1,"黑色", 2,"红色", 3,"青色", 4, "深灰色", 5,"灰色", 6,"绿色", 7,"浅灰色", 8,"洋红", 9,"橙色", 10,"粉红色", 11,"黄色", 12,"蓝色"
必填
page
int
页码
必填
x
float
x轴坐标,左下角为原点
必填
y
float
y轴坐标,左下角为原点
必填
positionName
String
签署位置名称,type为6时必传参数
必填

components请求示例

```language { "templateNumber": "9540EE3744D8F3A8", "structComponent": { "componentId": "a09d4ca1063b4666", "type": 1, "context": { "label": "测试单行文本", "required": true, "width": 10.00, "height": 10.00, "font": 2, "fontSize": 20, "textColor": 1, "page": 2, "x": 100, "y": 100 } } } ```

响应参数

参数名
类型
描述
必填
code
string
响应状态码( 0:成功 其他:失败)
必填
message
string
状态描述
必填
data
JSON
数据集
必填
componentId
String
组件ID
必填