获取文件上传地址

POST

http://127.0.0.1/v2.0/esign/files/uploadUrls

生态伙伴API/e签宝/e签宝2.0/文件

最后修改时间：2022-08-30 09:19:24

责任人：未设置

说明

调用本接口获取到文件上传地址。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	E签宝数据管理权限	API Explorer
第三方企业应用	支持	E签宝数据管理权限	API Explorer
第三方个人应用	暂不支持	E签宝数据管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	requestParamError	%s	请求参数错误
400	createOrgAccountError	创建企业账号异常	创建企业账号异常
400	getUserInfoError	获取用户信息异常	获取用户信息异常
400	getFileUploadUrlError	获取文件上传地址异常	获取文件上传地址异常

请求参数

Header 参数

serviceGroup

string

可选

预留参数，此版本无需此参数。

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

contentMd5

string

可选

ContentMD5值计算方法如下：

contentType

string

可选

目标文件的MIME类型，支持：
后面文件流上传的Content-Type参数要和这里一致，不然就会有403的报错。

fileName

string

可选

文件名称，必须带上文件扩展名，不然会导致后续发起流程校验过不去。例如：合同.pdf 。
该字段的文件后缀名称和真实的文件后缀需要一致。例如上传的文件类型是word文件，那该参数需要传xxx.docx，不能是xxx.pdf。

fileSize

integer

可选

文件大小，单位byte。

convert2Pdf

boolean

可选

是否转换成pdf文档，默认false，代表不做转换。转换是异步行为，如果指定要转换，需要调用查询文件信息接口查询状态，转换完成后才可使用。
如果本身就是PDF文件，该参数必须传false，否则在【通过模板创建文件】的时候不能填充内容。

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v2.0/esign/files/uploadUrls' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

fileId

string

文件ID。

可选

uploadUrl

string

可选

文件直传地址, 可以重复使用，但是只能传相同的文件，有效期一小时。

示例

{
  "fileId": "string",
  "uploadUrl": "string"
}

获取跳转到企业实名的地址

获取文件详情

获取文件上传地址

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码