LinkedIn API v2弃用后，如何通过新/rest/端点获取成员邮箱？

核心端点与请求规则 #

LinkedIn API v2弃用后，获取成员邮箱需使用Rest API的专用端点，具体信息如下：

请求URL #

https://api.linkedin.com/rest/emailAddress

必填项说明 #

• 请求方法：GET
• 核心权限：必须申请并获得r_emailaddress权限（需在应用审核阶段明确说明该权限的使用场景，否则无法通过审核）
• 请求头参数：
  • Authorization：格式为 Bearer {access_token}，其中{access_token}是通过OAuth2流程获取的有效访问令牌，且令牌必须包含r_emailaddress权限
  • LinkedIn-Version：指定API版本，建议使用当前最新稳定版（如202405，需与你在开发者平台配置的应用API版本一致）

请求示例 #

GET https://api.linkedin.com/rest/emailAddress
Authorization: Bearer YOUR_VALID_ACCESS_TOKEN
LinkedIn-Version: 202405

响应格式示例 #

成功请求后，返回的JSON结构如下：

{
  "elements": [
    {
      "handle": "urn:li:emailAddress:123456789",
      "handle~": {
        "emailAddress": "target_user@example.com"
      }
    }
  ]
}

关键注意事项 #

• 仅能获取授权当前应用的用户自身邮箱，普通第三方应用无法获取其他用户的邮箱
• 访问令牌过期或权限不足时，会返回对应的权限错误，需重新获取有效令牌或补充权限申请
• API版本号必须与应用配置匹配，否则会触发版本不兼容报错

内容的提问来源于stack exchange，提问作者Bryan Masias