通过上传方式创建模板

接口地址:/v1/docTemplates/createByUploadUrl

接口描述:

  1. 通过上传文件方式创建模板,上传方法请参考:文件流上传方法
  2. 模板仅支持PDF, 其他格式文档需转换成pdf后再使用。目前文档转换支持以下格式:DOC, DOCX, WPS, RTF, XLS, ET, XLSX, JPG, GIF, JPEG, BMP, PNG, TIF, TIFF, PPT, DPS, PPTX, HTM, HTML,其他格式会转换失败。为避免文档转换异常导致服务中断,强烈建议开发者自行将其他格式文档转换成PDF后再上传。
  3. 上传的模板大小限制在50M以内。

请求方式: POST

请求参数:

参数名 参数类型 必选 类型 说明
contentMd5 body string 模板文件md5值
contentType body string 目标文件的MIME类型
fileName body string 文件名称,必须带扩展名如: .pdf,.doc,.docx
convert2Pdf body boolean 是否需要转成pdf,如果模板文件为不是pdf则传true,是pdf则传false。转换是异步行为,如果指定要转换,需要调用查询模板基本信息接口查询模板状态,转换完成后才可使用。若使用文件转换,大小需限制在30M以内,大于30M的文件请先自行转成pdf后再上传。

请求示例:

POST https://openapi.esign.cn/v1/docTemplates/createByUploadUrl
{
    "contentMd5":"cTNpB5QZ8fAP9jScrV8teA==",
    "contentType":"application/octet-stream",
    "fileName":"测试模板.docx",
    "convert2Pdf":true
 }

响应参数:

参数名 类型 说明
templateId string 模板id
uploadUrl string 文件直传地址,需要用此上传地址使用put方式上传文件,只有文件上传后模板才可用

响应示例:

 {
    "code": 0,
    "data": {
        "templateId": "adfadfadfweweafadfadfa",
        "uploadUrl": "https://esignoss.oss-cn-hangzhou.aliyuncs.com/1111563786/5d45dc91-470b-41dd-8e6f-9663ee9641db/%E6%89%B9%E9%87%8F%E5%AF%BC%E5%85%A5-%E9%94%99%E8%AF%AF%E6%95%B0%E6%8D%AE.xls?Expires=1559294245&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=hBEuUHAC7TVxzRIr/BihG1m3QEQ%3D"
    },
    "message": "成功"
}

错误码

错误码 错误信息 错误原因

results matching ""

    No results matching ""