基础介绍
开发者在发起签署时传入文件名称 fileName,即可自定义签署页面及最终存储的文件名称。
fileName 用于定义并显示待签署文件的名称,主要作用如下:
- 文件标识:在签署页面中向签署方清晰展示文件名称,便于识别当前签署内容。
- 文件存储:签署完成后,该名称将作为已签署文件的存储文件名。
文件名称fileName参数格式要求:
- 禁止包含以下 9 种特殊字符:/ \ : * " < > | ? 以及所有 emoji 表情符号。
- 文件名长度限制:不超过 100 个字符(包括 .pdf 后缀)。
效果展示
PC端-单份文件展示效果

PC端-多份文件展示效果

移动端-单份文件展示效果

移动端-多份文件展示效果


API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 |
基于文件发起签署接口代码案例
相关参数
- fileName 文件名称(需要添加PDF文件后缀名,“xxx.pdf”)

注:如发起签署时未指定文件名称,则取《上传本地文件》接口传入的文件名称(fileName)。
指定文件名称入参样例
{
"docs": [
{
"fileId": "文件id",
"fileName": "测试1.pdf"
},
{
"fileId": "文件id",
"fileName": "测试2.pdf"
}
]
}