使用Share on LinkedIn API发布图文帖异常：返回成功但内容不可见

以下是针对你遇到的问题（返回201状态码、有帖子URN但主页/信息流不可见）的排查和修复步骤：

1. 验证图片资产的实际状态 #

虽然你提到图片已上传注册，但需确认资产是否真的处于可用状态。调用LinkedIn的资产查询API：

import requests

asset_url = f"https://api.linkedin.com/v2/assets/{upload_urn.split(':')[-1]}"
response = requests.get(asset_url, headers=headers)
print(response.json())

检查返回结果中的status字段，必须为AVAILABLE才代表图片处理完成。如果是PROCESSING，需等待一段时间再发布帖子，或重新上传图片。

2. 补充媒体对象的必填字段 #

LinkedIn的图文分享要求媒体对象包含title字段，你的代码中缺少该字段，这可能导致帖子被隐藏。修改media数组中的对象：

"media": [
    {
        "status": "READY",
        "description": {
            "text": "Work in progress"
        },
        "title": {
            "text": "帖子配图"  # 补充标题字段
        },
        "media": upload_urn
    }
]

3. 确认权限范围 #

检查请求头中的Access Token是否包含以下必要权限：

• w_member_social：发布用户内容的权限
• rw_assets：上传和管理媒体资产的权限
  如果权限缺失，需重新申请授权，确保勾选上述权限。

4. 添加Restli协议版本头 #

在请求头中添加X-Restli-Protocol-Version字段，确保API请求符合最新协议规范：

headers['X-Restli-Protocol-Version'] = '2.0.0'

5. 测试可见性范围 #

暂时将可见性从PUBLIC改为CONNECTIONS，测试帖子是否能在你的主页和好友信息流中显示：

"visibility": {
    "com.linkedin.ugc.MemberNetworkVisibility": "CONNECTIONS"
}

如果切换后可见，说明可能是LinkedIn的公共内容审核机制导致帖子被延迟展示或隐藏，需检查内容是否符合平台规范。

6. 等待内容同步延迟 #

部分情况下，LinkedIn的内容同步可能存在延迟，即使通知和分析显示发布，主页和信息流可能需要5-10分钟才能显示，可等待一段时间后再检查。

内容的提问来源于stack exchange，提问作者Rishab Agrawal