如何通过JavaScript网页应用读取Apple用户账户的联系人列表

是存在对应实现方式的，主要分为两种场景可选，和Google People API、Microsoft Graph API的授权调用逻辑基本一致：

1. 全量联系人读取方案（对接Apple生态接口） #

使用Apple官方提供的CloudKit JS配合Sign in with Apple能力实现，操作流程如下：

• 首先在Apple Developer后台完成网页应用登记，开通Sign in with Apple服务，同时申请联系人读取权限
• 前端引入CloudKit JS SDK，在触发Sign in with Apple授权时，在授权scope中添加contacts字段
• 用户完成授权并同意开放联系人权限后，即可调用CloudKit JS提供的联系人查询接口，拉取用户iCloud账户下同步的全量联系人数据

使用该方案需要注意以下限制：

• 权限审核要求高：Apple会严格审核你读取联系人的用途，必须和应用核心功能强相关，且需要明确告知用户数据使用规则，否则权限申请会被驳回
• 域名限制：只能在你在开发者后台登记的合法域名下调用相关接口，本地开发需要提前配置测试域名和测试账号
• 数据范围限制：仅能返回Apple允许公开的联系人标准字段，不会返回用户的隐私关联信息

2. 按需读取联系人方案（通用浏览器原生接口） #

如果你不需要批量拉取用户的全量联系人，仅需要用户主动选择个别联系人提供给你的应用，可以直接使用W3C标准的Contact Picker API，Safari 14.1及以上版本已经完整支持该接口，不需要对接Apple的私有开发接口，也不需要申请开发者权限，调用示例如下：

// 兼容性判断
if ('contacts' in navigator && 'ContactsManager' in window) {
  // 指定需要获取的联系人字段
  const requiredFields = ['name', 'tel', 'email', 'address'];
  // 配置是否支持多选
  const options = { multiple: true };

  try {
    // 唤起系统联系人选择器
    const selectedContacts = await navigator.contacts.select(requiredFields, options);
    // 处理用户选择的联系人数据
    console.log(selectedContacts);
  } catch (error) {
    console.log('联系人读取失败或用户取消授权', error);
  }
}

该方案的优势是无额外申请流程，所有现代浏览器都可以通用调用，用户自主选择要分享的联系人，隐私风险更低，审核风险也更小。

内容的提问来源于stack exchange，提问作者Sithira Pathirana