Share on LinkedIn | LinkedIn Developer Network

领英是一个有效的内容平台，B2B 营销人员告诉我们，他们获得的社交网络流量中有一半来自领英。领英能让您的内容触达正在寻找相关文章和信息的职场人士。

使用“分享到领英”功能:

提高用户数量并提升网站流量
将您的内容展示给数百万的职场人士
会员在职业社交网站上分享您的内容，实现病毒式传播

希望怎样分享到领英？

开始之前……

请务必阅读 REST API 入门指南，了解如何在应用中成功分享领英内容的重要信息。

通过 REST API 分享内容有两种方法。无论您选择哪种方式，API 端点均相同，仅请求正文的格式不同。

在评论中添加要分享的内容网址 - 领英会对所含网址进行分析，并自动识别标题、说明、图片等。
使用特定值分享 - 您可以通过 API 调用的参数直接提供标题、说明、图片等。

POST	`https://api.linkedin.com/v1/people/~/shares?format=json`

请求正文

字段名称		字段描述	字数上限 (字符数)
content		一系列描述分享内容的字段。
	title	分享内容的标题。	200
	description	分享内容的说明。	256
	submitted-url	分享内容的完全限定网址。	无
	submitted-image-url	分享内容缩略图的完全限定网址。为达到最佳效果，图片应至少为 80 x 150px。	无
comment		会员针对分享内容所做的评论。如果未提供以上内容参数，则评论必须包含分享内容的网址。如果评论中包含多个网址，则只分析分享内容的第一个网址。	700
visibility		一些有关分享内容的公开性信息。
	code	以下其中一个值: anyone: 分享内容对所有会员公开。 connections-only: 分享内容仅对进行分享者的联系人公开。此字段是所有分享调用中的必填字段。	无

通过带网址的评论进行分享

若要通过在评论中引用网址分享领英内容，在请求正文中仅需提供 comment 和 visibility 参数:

JSON

{
  "comment": "Check out developer.linkedin.com! http://linkd.in/1FC2PyG",
  "visibility": {
    "code": "anyone"
  }
}

如果您选择提供 JSON 格式的正文，应确保您的 HTTP 请求中包含以下标题信息:

JSON 正文的必填 HTTP 标题

Content-Type: application/json
x-li-format: json

或者，您可提供以下 XML 格式的正文，无需提供其他 HTTP 标题:

xml 文章正文

<share>
  <comment>Check out developer.linkedin.com! http://linkd.in/1FC2PyG</comment>
  <visibility>
    <code>anyone</code>
  </visibility>
</share>

使用特定值进行分享

如果您的应用具有分享内容的所有信息，则分享该内容的最佳方式是在 API 调用中直接提供这些值:

JSON 文章正文

{
  "comment": "Check out developer.linkedin.com!",
  "content": {
    "title": "LinkedIn Developers Resources",
    "description": "Leverage LinkedIn's APIs to maximize engagement",
    "submitted-url": "https://developer.linkedin.com",  
    "submitted-image-url": "https://example.com/logo.png"
  },
  "visibility": {
    "code": "anyone"
  }  
}

要使用 JSON 格式分享内容，应确保您的 HTTP 请求中包含以下标头信息:

JSON 正文的必填 HTTP 标题

Content-Type: application/json
x-li-format: json

或者，您可提供以下 XML 格式的正文，无需提供其他 HTTP 标题:

XML 文章正文

<share>
  <comment>Check out developer.linkedin.com!</comment>
  <content>
    <title>LinkedIn Developer Resources</title>
    <description>Leverage LinkedIn's APIs to maximize engagement</description>
    <submitted-url>https://developer.linkedin.com</submitted-url>
    <submitted-image-url>https://example.com/logo.png</submitted-image-url>
  </content>
  <visibility>
    <code>anyone</code>
  </visibility>
</share>

成功响应

如果分享请求成功，您将收到 HTTP 201 响应代码和以下请求正文:

响应示例

{
  "updateKey": "UPDATE-3346389-595113200…",
  "updateUrl": "https://www.linkedin.com/updates?discuss=…&scope=…"
}

updateKey 是专为分享内容文章而创建的唯一 ID。updateURL 值是指向 LinkedIn.com 最新分享内容的直接链接，您可指示用户的网络浏览器访问此链接。

重复分享

为了避免在领英推送内容中出现垃圾信息，您不可重复发布相同的分享内容。如果您这样做，API 调用将返回一个 HTTP 400 错误:

{
  errorCode: 0, 
  message: "Do not post duplicate content", 
  requestId: "ABC123DEF", 
  status: 400, 
  timestamp: 1420102800000 
}

权限和限制

所需权限: w_share

无论是设置成应用设置中的默认权限，还是通过范围参数在验证过程中专门提出请求，您都需要请求 w_share 会员权限，使应用可以成功通过 API 调用分享内容。

节流限制

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

使用 Open Graph 改善内容分享

如果您是内容作者，且希望改善本人或其他任何人分享您的领英内容的效果，您可在 HTML 页面的 <head> 中包含 Open Graph 标准的 <meta> 标签，由此控制领英 (以及其他大部分主要内容分享平台) 可以在分享内容中展示的信息。

如果存在 Open Graph 标签，领英的抓取工具将无需依赖自身的分析确定要分享哪些内容，从而提高所分享信息与您希望分享信息吻合的机率。

Open Graph 元标签示例

<html prefix="og: http://ogp.me/ns#">
<head>
  <meta property="og:title" content="My Shared Article Title" />
  <meta property="og:description" content="Description of shared article" />
  <meta property="og:url" content="http://example.com/my_article.html" />
  <meta property="og:image" content="http://example.com/foo.jpg" />
</head>
<body>
   …
</body>
</html>

为确保 LinkedIn.com 上的内容具有出色的展示效果，og:image 中引用的图片应至少为 80 x 150px，避免为配合排版而拉伸图片。

如果您通过 API 调用直接分享内容，将有机会使用 API 调用的参数控制要分享的确切信息。

分享内容缓存

领英抓取工具通过网址分享内容而首次访问网页时，它所找到的数据 (Open Graph 值或我们自己的分析) 将被缓存大约 7 天时间。

如果您随后更改文章描述、上传新图片、修改标题中的错别字等，这些更改将不会在随后分享的页面中看到，直至缓存到期且抓取工具重新访问页面以检索新内容。

如果您通过 API 调用直接提供要分享的内容，而不是通过要求分析的网址提供内容，领英将始终使用您所提供的值。