通过SharePoint应用暴露API端点实现文件上传至指定站点的可行性及方案

完全可行。部署在SharePoint中的应用/插件（如SPFx、Provider-hosted Add-in）自带应用级权限上下文，不需要依赖用户授予的SharePoint API访问权限——只要在应用部署阶段申请了目标站点的对应权限，就能实现接收第三方REST请求并将文件存入指定站点的需求。

1. 选择应用类型 #

优先考虑两种方案：

• SPFx (SharePoint Framework)：轻量型场景首选，直接部署在SharePoint环境内，天然绑定站点权限上下文。
• Provider-hosted Add-in：适合需要独立托管后端逻辑的场景，可通过应用权限令牌访问SharePoint资源。

2. 暴露API端点 #

针对SPFx #

SPFx本身无法直接暴露独立API端点，通常需要结合Azure Function做后端代理：

1. 在Azure中创建Function App，编写接收multipart/form-data请求的HTTP触发器，用于接收第三方上传的文件。
2. 为Azure Function配置SharePoint应用权限，通过PnP.js或SharePoint REST API完成文件存储操作。
3. 将SPFx与Azure Function关联，确保权限上下文传递正确。

针对Provider-hosted Add-in #

这是更直接的方案，可在应用后端直接创建API端点：

1. 在你的后端服务（如ASP.NET Core、Node.js）中创建REST接口，配置支持multipart/form-data类型的请求，用于接收文件。
2. 利用SharePoint Add-in注册时获取的Client ID和Client Secret，生成应用级访问令牌，调用SharePoint REST API或CSOM将文件上传至目标站点的文档库。

3. 配置应用权限 #

• 无论是SPFx还是Provider-hosted Add-in，都需要在部署/注册阶段向SharePoint申请目标站点的读写权限（遵循最小权限原则，比如Web.Write即可满足文件写入需求）。
• Provider-hosted Add-in需在SharePoint管理中心注册应用，指定权限范围为目标站点，获取Client ID和Client Secret后用于生成访问令牌。

4. 代码示例（Node.js + Provider-hosted Add-in） #

const express = require('express');
const multer = require('multer');
const { Client } = require('@pnp/sp');
const fs = require('fs');
const app = express();
const upload = multer({ dest: './temp/uploads/' });

// 初始化PnP.js客户端，使用应用权限
const spClient = new Client('https://your-target-sharepoint-site-url');
spClient.setAuthentication({
  clientId: 'your-app-client-id',
  clientSecret: 'your-app-client-secret',
});

// 文件上传API端点
app.post('/api/upload-to-sp', upload.single('uploadedFile'), async (req, res) => {
  if (!req.file) {
    return res.status(400).send('未检测到上传文件');
  }

  try {
    // 读取临时文件内容
    const fileContent = fs.readFileSync(req.file.path);
    // 上传到SharePoint文档库
    await spClient.web.getFolderByServerRelativeUrl('/sites/target-site/Shared%20Documents')
      .files.add(req.file.originalname, fileContent, true); // true表示覆盖同名文件

    // 清理临时文件
    fs.unlinkSync(req.file.path);
    res.status(200).json({ message: '文件已成功上传至SharePoint' });
  } catch (error) {
    res.status(500).json({ error: `上传失败：${error.message}` });
  }
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`API服务运行在端口 ${PORT}`));

如果上述开发方案受限，可考虑低代码/无代码方案：

• Power Automate HTTP触发器：创建一个Power Automate流，设置HTTP请求触发器作为API端点，接收第三方的文件上传请求，再通过SharePoint连接器将文件存入指定站点的文档库。此方案无需编写代码，快速实现需求。
• SharePoint文档库邮件接收：若第三方系统支持发送带附件的邮件，可配置目标文档库启用“接收电子邮件”功能，第三方直接发送带附件的邮件到指定地址，文件会自动存入文档库。

内容的提问来源于stack exchange，提问作者Ramesh Perera