钉钉开发文档

管理媒体文件

更新时间: 2018-12-17

上传媒体文件

用于上传图片、语音媒体资源文件以及普通文件(如doc、ppt),接口返回媒体资源标识media_id。请注意:

  • media_id是可复用的,同一个media_id多次使用。
  • media_id对应的资源文件,仅能在钉钉客户端内使用。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/media/upload?access_token=ACCESS_TOKEN&type=TYPE

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

参数说明

参数 参数类型 必须 说明
access_token String 调用接口凭证
type String 媒体文件类型,分别有图片(image)、语音(voice)、普通文件(file)
media String form-data中媒体文件标识,有filename、filelength、content-type等信息

SDK请求示例(JAVA)

DingTalkClient  client = new DefaultDingTalkClient("https://oapi.dingtalk.com/media/upload");
OapiMediaUploadRequest request = new OapiMediaUploadRequest();
request.setType("image");
request.setMedia(new FileItem("/Users/mxh/Downloads/test.png"));
OapiMediaUploadResponse response = client.execute(request,accessToken);

返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "type": "image",
    "media_id": "@dsa8d87y7c8d8c",
    "created_at":1442027997327
}
参数 说明
errcode 错误码
errmsg 错误信息
type 媒体文件类型,分别有图片(image)、语音(voice)、普通文件(file)
media_id 媒体文件上传后获取的唯一标识
created_at 媒体文件上传时间戳

上传的媒体文件限制

  • 图片(image):1MB,支持JPG格式
  • 语音(voice):2MB,播放长度不超过60s,AMR格式
  • 普通文件(file):10MB
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!