LinkedIn API按Vanity Name查询组织返回500内部服务器错误求助

问题概述 #

调用LinkedIn的「Find Organization by Vanity Name」接口时，持续收到500 Internal Server Error。已尝试202307和202311两个API版本，结果一致，且未在官方文档中发现相关接口变更。

请求示例 #

curl --location 'https://api.linkedin.com/rest/organizations?q=vanityName&vanityName=LinkedIn' \
--header 'Content-Type: application/json' \
--header 'LinkedIn-Version: 202311' \
--header 'X-Restli-Protocol-Version: 2.0.0' \
--header 'Authorization: Bearer ...'

返回结果 #

{"message":"Internal Server Error","status":500}

排查建议 #

• 验证Bearer令牌有效性：确认令牌未过期，且权限范围包含接口要求的r_organization_social或rw_organization_admin权限
• 核对vanityName准确性：确保传入的vanityName与目标组织公开的vanity名称完全匹配（注意大小写、特殊字符差异）
• 显式指定返回字段：尝试在请求URL中添加fields参数，比如&fields=id,name,vanityName，部分场景下服务器会因字段未指定触发内部错误
• 检查请求头格式：确认LinkedIn-Version为纯数字格式（如202311），X-Restli-Protocol-Version保持2.0.0不变
• 提交官方支持工单：若以上操作均无效，通过LinkedIn开发者平台提交支持工单，附上完整请求日志（需隐去敏感的Bearer令牌）

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