上传媒体文件后发送工作通知

本文档介绍了如何调用文件存储和消息通知相关接口实现媒体文件使用的相关流程。首选创建一个企业内部应用，再使用文件存储和消息通知提供的API，实现上传媒体文件、发送消息通知流程。

简介

本教程通过操作步骤和示例，帮助企业开发者通过本文的教程内容，快速完成媒体文件的上传，上传成功后对特定人群发送通知。

帮助开发者能快速掌握搭建属于自己的应用，同时依赖钉钉基础接口，完成附件上传和工作通知的能力。

面向所有钉钉开发者。

通过免登方式获取当前登录人员的姓名、角色等信息，登录可参考网页应用（H5微应用）免登。
通过上传媒体文件接口，上传特定文件（当前教程的文件是本地文件，在实际过程中开发者可自定义文件），获取文件的media_id（文件唯一标识）。
根据媒体文件media_id，调用服务端API-发送工作通知接口，进行发送工作通知消息（本文提供了图片+action 两种类型的消息通知，在代码中可进行切换）。

填写应用信息。

配置项	是否必填	配置说明
应用名称	是	输入应用名称，应用名称最小长度为 2 个字符。
应用描述	是	简要描述应用提供的产品或服务，应用描述最小长度为 4 个字符。
应用图标	否	上传应用图标，图标要求 JPG/PNG 格式、240 px * 240 px 以上、1:1 、2 MB 以内的无圆角图标。

单击保存，进入应用详情页，单击基础信息 > 凭证与基础信息，查看应用 Client ID 、Client Secret 和 AgentId。
注意：保存 Client ID 、Client Secret 和AgentId，后续需要使用。

在应用详情页，单击应用能力 > 添加应用能力。
选择添加网页应用。
配置网页应用（H5）信息：
配置项 说明
应用首页地址填写应用首页地址，本示例使用：http://localhost:5173?corpid=$CORPID$用于后续测试。本示例仅用于本地测试。 image
PC端首页地址
配置完成后，单击保存。

配置项	说明
应用首页地址	填写应用首页地址，本示例使用：`http://localhost:5173?corpid=$CORPID$`用于后续测试。本示例仅用于本地测试。 image
PC端首页地址

权限默认开通，无需申请相应权限。

配置版本信息：

配置完成后，单击下方保存。

确保已经完成上述步骤，获取下方 Demo 运行的参数信息。
你可以下载 file-demo.zipDemo。
打开 IDE，并导入已下载的 Demo。
示例代码分为 backend（后端代码目录）和frontend（前端代码目录）。
打开后端代码目录，在 resources 目录中修改application.properties文件，填写clientId（应用Client ID）、clientSecret（应用Client Secret）、filepath（需要上传文件的绝对路径）、agentId（应用的AgentId） 等参数。
点击启动后端服务。说明
- 在启动后端服务前，请确保已经正确安装Maven 和 JDK，并配置了相关环境；如果是初次安装 IDE，需要在 IDE 中修改相关配置文件。
- 确保 5173 和 8080 端口没有被占用。
打开前端代码目录，修改 vite.config.ts,并填写正确的clientId（应用Client ID）。
点击前端项目文件，鼠标右键并选择终端打开。
在终端窗口中，输出以下命令：
1. npm install
2. npm run dev
  注意：windows 在启动时候，请使用npm run dev:raw。
至此，前端和后端服务已经启动成功。