领英拥有四亿会员，是全球最大的职业社交平台。 利用领英的强大功能，极大地提升您网站和应用的登录体验。

“用领英登录”功能:

  • 用户可通过领英帐号登录，无需新建帐号，从而简化注册步骤，提高新用户数量
  • 简化自行登录、个人资料管理、密码更改和恢复等流程，大大缩短成本和时间
  • 使用最新的会员个人资料数据，对网站和应用进行个性化设置

如何整合“用领英登录”功能？

开始之前……

请务必阅读 REST API 入门指南。了解有关在应用中成功整合“用领英登录”功能的重要信息。

第 1 步 - 授权用户

授权当前用户后，“用领英登录”便基本大功告成。如果之前未存储当前用户的访问令牌，请按照使用 OAuth 2.0 授权指南中概述的步骤，获取在下一步登录过程中要使用的新访问令牌。

如有需要，您可从图片资源版块将官方领英按钮图片下载到项目中。

请参见权限和限制，确保应用在 OAuth 2.0 授权流程期间为此 API 调用请求正确的会员权限。

第 2 步 - 读取领英会员资料基本数据

获得用户的有效访问令牌后，您便可借助以下 REST API 调用读取该用户的领英个人资料基本数据:

GET 
https://api.linkedin.com/v1/people/~?format=json
API 响应示例
{
  "firstName": "悟空",
  "headline": "水帘洞美猴王",
  "id": "1R2RtA",
  "lastName": "孙",
  "siteStandardProfileRequest": {
    "url": "https://www.linkedin.com/profile/view?id=…"
  }
}

拥有这些基本的个人资料信息，便可认为已完成登录流程，您可以在应用中继续体验其他功能。

请求其他个人资料字段

在默认情况下，领英不会返回对您可用的所有可能的会员个人资料字段。领英仅提供与您的应用相关、数量有限的会员字段。请参照个人资料基本字段页面，了解基本的会员个人资料字段的完整列表。

以下示例演示了如何定制 API 调用，以请求您希望在“用领英登录”中获得的特定会员个人资料字段:

GET 
https://api.linkedin.com/v1/people/~:(id,first-name,last-name,formatted-name,num-connections,picture-url)?format=json
API 响应示例
{
  "id": "1R2RtA",
  "firstName": "悟空",
  "lastName": "孙",
  "formattedName": "孙悟空",
  "numConnections": 42,
  "pictureUrl": "https://media.licdn.com/mpr/mprx/…"
}

请求备用的个人资料语言

领英会员有机会以多种语言提供个人资料信息。 如要指定您希望返回信息使用的语言，可在调用中添加 Accept-Language HTTP 标头。标头值应是由逗号分隔的语言代码列表，按照优先级从高到低的顺序依次排列。

请注意，这些值是未经过本地化处理或自动转化的值。仅可用的非英语信息是由会员手动输入的信息。

Http 标头示例
Accept-Language: es-ES, en-US, it-IT

标头值未被严格执行，因此 API 将在可行的情况下始终尝试返回数据。  如果您指定某种特定语言，且会员没有与之匹配的个人资料数据，它将以会员的主要语言返回数据，而非不返回任何数据。

图片资源

Sign in with LinkedIn

从“领英品牌资源”存档中分别下载各种分辨率和大小格式的“用领英登录”官方按钮图片，用于您的项目。

权限和限制

必要权限: r_basicprofile

无论是设置为应用设置中的默认权限，还是通过范围参数在授权流程中专门提出请求，您都需要请求 r_basicprofile 会员权限，使应用可以成功通过 API 调用“用领英登录”。

节流限制

节流类型 每日调用限制 (UTC)
应用最大值                                                                                                     100,000
每个用户
 n/a
每个开发人员 n/a