如何通过Payload CMS调用外部后端服务获取数据？

完全可行，Payload作为可扩展的Headless CMS，支持通过多种方式整合外部服务的数据，同时保留自身MongoDB数据与API的使用。以下是几种实用方案：

1. 自定义合并数据API端点 #

在Payload中创建自定义路由，统一处理自身数据与旧后端数据的查询、合并，UI只需调用这个端点就能拿到整合后的数据：

• 在src/routes目录下新建路由文件（比如merged-data.js），编写逻辑：

const express = require('express');
const router = express.Router();
const payload = require('payload');
const axios = require('axios');

router.get('/', async (req, res) => {
  const { id } = req.query;
  try {
    // 获取Payload自身集合数据
    const payloadItem = await payload.findByID({
      collection: '你的目标集合slug',
      id,
    });
    // 调用旧后端服务获取数据
    const oldServiceData = await axios.get('https://apigateway/abc', { params: { id } });
    // 合并并返回数据
    res.json({
      ...payloadItem,
      externalData: oldServiceData.data
    });
  } catch (err) {
    res.status(500).json({ error: '获取数据失败' });
  }
});

module.exports = router;

• 在Payload配置文件中注册该路由，之后UI调用https://payloadcms/api/merged-data?id=1即可获取整合后的数据。

2. 在集合钩子中自动注入外部数据 #

如果希望复用Payload原有集合的API（比如/api/your-collection/:id），可以通过afterRead钩子在返回数据前自动添加旧后端的数据：
在目标集合的配置文件中添加钩子逻辑：

const yourCollection = {
  slug: 'your-collection',
  // 其他集合配置（字段、权限等）
  hooks: {
    afterRead: [
      async ({ doc }) => {
        try {
          // 根据当前文档ID调用旧后端
          const externalRes = await axios.get('https://apigateway/abc', { params: { id: doc.id } });
          // 注入外部数据到返回结果
          doc.externalData = externalRes.data;
        } catch (err) {
          // 处理外部请求失败的情况，避免影响Payload自身数据返回
          doc.externalData = null;
        }
        return doc;
      }
    ]
  }
};

module.exports = yourCollection;

这样UI调用Payload原生的集合详情API时，返回结果会自动包含旧后端的对应数据。

3. 前端层聚合（备选） #

如果不想改动Payload后端，也可以在UI代码中分别调用Payload API和旧后端API，在前端完成数据合并。但这种方式需要处理两次异步请求的时序问题，适合简单场景。

注意事项 #

• 务必处理外部服务的请求异常，避免因旧后端故障导致Payload API不可用
• 可添加本地缓存或Redis缓存，减少重复请求旧后端，提升响应速度
• 确保Payload服务器能够访问旧后端的API地址，必要时配置网络白名单或API密钥验证

内容的提问来源于stack exchange，提问作者Anurag Patil