POST/esignglobal/v1/envelope/recipients/addSigners
Mô tả giao diện
Thêm người ký vào phong bì, người ký là nhiệm vụ ký. Bao gồm thêm các điều khiển, phương thức xác thực, v.v. cho người ký.
Lưu ý:
- Hỗ trợ thêm người ký mới sau khi phong bì được mở. Thứ tự ký của người ký mới được thêm vào không được nhỏ hơn hoặc bằng giá trị thứ tự ký của bất kỳ người ký nào đang ký.
- Không cho phép thêm cùng một người ký (với email là định danh duy nhất của người dùng) nhiều lần. Nếu bạn cần cập nhật thông tin nhiệm vụ ký, vui lòng thêm lại người ký tương ứng.
- Một phong bì chỉ có thể có tối đa 10 người ký.
Tham số yêu cầu
Ví dụ yêu cầu
{
"envelopeId": "{{envelope-id}}",
"signerInfos": [
{
"userEmail": "sender_user@esignglobal.com",
"userName": "sender_user_name",
"signOrder": 1,
"authModes": "sms",
"authConfig": {
"sms": {
"countryCode": "86",
"number": "158****9242"
}
},
"sealInfos": [
{
"fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c",
"signConfigs": [
{
"fieldType": "stamp",
"pageNo": "1",
"posX": 100.22,
"posY": 100
}
],
"fillConfigs": [
{
"fieldId": "df0dd777bcc4d108de242d",
"fieldKey": "demo",
"pageNo": "1",
"posX": "88.70021",
"posY": 745.409,
"fieldType": "1",
"required": true,
"textField": {
"overflowType": "1",
"minFontSize": 8,
"font": "6",
"fontSize": "12",
"textColor": "#54ACD2",
"bold": false,
"italic": true,
"lineThrough": false,
"horizontalAlignment": "RIGHT"
}
},
{
"fieldId": "96e6c7d414f04e98938ea84013b",
"fieldKey": "红色加深斜体下划线删除线",
"pageNo": "1",
"posX": 94.516624,
"posY": 284.54953,
"fieldType": "1",
"required": false,
"textField": {
"overflowType": "1",
"minFontSize": 10.5,
"font": "1",
"fontSize": 12.0,
"textColor": "#E25041",
"bold": true,
"italic": true,
"lineThrough": true,
"horizontalAlignment": "LEFT"
}
},
{
"fieldId": "888b899853544c49bd819d9f6d1",
"fieldKey": "必填勾选控件选中样式不显示边框",
"pageNo": "3",
"posX": 451.77127,
"posY": 429.07626,
"fieldType": "15",
"required": true,
"tickBoxField": {
"tickOptions": [1,2],
"showBorder": false
}
}
]
"signDateConfigs":[
"pageNo":"1",
"posX": 100.22,
"posY": 100,
"signDateFormat": "dd MMM yyyy"
]
}
]
}
]
}
Tham số phản hồi
Ví dụ phản hồi
{
"code": "0",
"data": {
"signerInfos": [
{
"organizationName": "Esign Global CO.",
"userLastName": "",
"accessCode": "",
"userEmail": "sender_user@tsign.cn",
"userFirstName": "",
"signOrder": "1"
}
],
"signFiles": [
{
"fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
}
],
"attachments": [
],
"envelopeId": "9fbe6c8190824227bde29136b0145c81"
},
"message": "success"
}