上传媒体文件

POST

/media/upload

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

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

接口调用说明

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

media_id是可复用的，同一个media_id多次使用。

media_id对应的资源文件，仅能在钉钉客户端内使用。

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	默认开通，无需申请	调试
第三方企业应用	是	默认开通，无需申请	调试

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/media/upload?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "media_id": "$iAEKAqNwbmcDBgTNAk",
    "created_at": 1605863153573,
    "type": "image"
}

修改于 2024-01-15 07:45:10

权限申请

概述

上传媒体文件

接口调用说明#

权限#

请求参数

返回响应

接口调用说明

权限