如何获取Appwrite Magic URL认证所需的userID？

核心思路 #

你遇到的问题本质是createMagicURLSession API的设计要求绑定用户唯一ID与邮箱，但登录前无法直接通过邮箱拿到ID。解决的关键是先通过邮箱完成用户的查询或创建，拿到对应的userID后再发起Magic URL请求。

具体步骤 #

• 第一步：通过邮箱查询用户ID
  如果你的系统已有用户管理逻辑，先调用后端接口（或第三方服务的查询API），传入用户邮箱来获取对应的userID。示例代码：

  // 调用后端接口查询用户ID
  async function getUserIdByEmail(email) {
    const response = await fetch(`/api/users?email=${encodeURIComponent(email)}`);
    const user = await response.json();
    return user?.id; // 存在则返回ID，不存在返回undefined
  }
  

• 第二步：处理新用户（首次登录）
  如果查询后发现用户不存在，需要先创建用户并获取系统生成的userID：

  // 创建新用户并获取ID
  async function createUserWithEmail(email) {
    const response = await fetch('/api/users', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ email })
    });
    const newUser = await response.json();
    return newUser.id;
  }
  

• 第三步：发起Magic URL请求
  拿到userID后，再调用createMagicURLSession：

  async function startMagicLogin(email) {
    let userId = await getUserIdByEmail(email);
    if (!userId) {
      userId = await createUserWithEmail(email);
    }
    // 传入正确的userID发起请求
    const promise = account.createMagicURLSession(userId, email);
    const session = await promise;
    console.log('Magic URL会话创建成功', session);
  }
  

额外提示 #

如果这个API必须要求userID，说明其设计逻辑是将Magic URL与用户唯一ID绑定，而非直接绑定邮箱。如果觉得流程繁琐，建议查看对应服务的官方文档，确认是否存在仅通过邮箱即可发起Magic URL登录的简化API（很多实现会提供这种更友好的方式）。

内容的提问来源于stack exchange，提问作者Vincent Ge