
尊敬的客户:
因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/)中的在线咨询入口进行咨询。