上传媒体文件旧版SDK

更新于 2023-05-24

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，上传图片、语音媒体资源文件以及普通文件，接口返回媒体资源标识media_id。

接口调用说明

调用本接口，上传媒体文件后，可获取媒体资源标识media_id。关于media_id：

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

请求方式：POST

请求地址：https://oapi.dingtalk.com/media/upload

说明

使用multipart/form-data POST上传文件，文件标识名为media。

名称

类型

是否必填

示例值

描述

access_token

String

是

6d1bxxxx

调用该接口的应用凭证。

名称

类型

是否必填

示例值

描述

type

String

是

image

媒体文件类型：

重要

如果使用C#调用该接口出现40004（不合法的媒体文件类型）错误，需将参数type加在请求的URL后面。

media

FileItem

是

C:/Users/Desktop/222.png

要上传的媒体文件。

form-data中媒体文件标识，有filename、filelength、content-type等信息。

名称	类型	示例值	描述
errcode	Number	0	返回码。
errmsg	String	ok	返回码描述。
type	String	file	媒体文件类型： image：图片 voice：语音 file：普通文件 video：视频
media_id	String	@#lAzPDgCwPn1mJiDOQoLpxxxx	媒体文件上传后获取的唯一标识。
created_at	Number	1599556098964	媒体文件上传时间戳。