关于“电子签名 SaaS API 标准版”文件名称新增特殊字符限制的通知

尊敬的客户：

因Windows操作系统中文件名称不支持特殊字符，电子签名API服务接口入参增加文件名称特殊字符校验。1月14日起所有涉及文件名称的入参不可以含有以下9个特殊字符/ \ : * " < > | ？ 以及所有emoji表情。

特殊字符校验上线日期：2021年1月14日

贵司需要配合的事项：将此链接转发给贵司的开发技术人员，让其按照本文进行代码检查或调整。

影响范围：对接e签宝电子签名 SaaS API 非标版和 电子签名 SaaS API 标准版的客户

影响接口和参数范围如下：

①通过上传方式创建文件 /v1/files/getUploadUrl的入参fileName

②通过上传方式创建模板 /v1/docTemplates/createByUploadUrl的入参fileName

③通过模板创建文件 /v1/files/createByTemplate的入参name

④一步发起签署 /api/v2/signflows/createFlowOneStep的入参businessScene，attachmentName，fileName

⑤签署流程创建 /v1/signflows的入参businessScene

⑥流程文档添加 /v1/signflows/{flowId}/documents的入参fileName

⑦流程附件添加 /v1/signflows/{flowId}/attachments的入参attachmentName

以上所述接口中的参数值如果含有 / \ : * " < > | ？这9个特殊字符以及emoji表情时将会调用接口失败报错如下：

“参数错误: 名称包含特殊字符”

附注：上述 ①②③ 条限制校验计划上线时间：2021年1月14日，④⑤⑥⑦ 条限制校验计划1月14日按整体规划节奏逐步增加。

我们建议贵司本次将上述 ①②③④⑤⑥⑦ 中涉及接口和参数全部检查并调整，后续将不再另做通知。

代码调整过程中遇到问题，请贵司开发技术人员通过 之前已与e签宝建立的技术交流群进行咨询。或通过e签宝开放平台（https://open.esign.cn/）中的在线咨询入口进行咨询。