
在使用领英(linkedin)视频api进行视频上传时,特别是对于超过4mb需要分块上传的视频,开发者可能会遇到一个令人困惑的问题:尽管视频的初始化上传请求(initializeupload)和所有分块上传都看似成功,并正确收集了每个分块的etag,但在执行最终的上传确认(finalizeupload)操作时,api却返回500(internal server error)或504(gateway timeout)错误。
这种现象通常表现为:
开发者可能已经尝试过增加客户端超时时间、验证文件分块的完整性等常规排查手段,但问题依然存在。这表明问题可能并非出在客户端逻辑或网络连接上,而是与API本身或其配置有关。
经过深入排查,发现导致finalizeUpload操作失败的根本原因在于使用了错误的API端点URL。在某些情况下,尤其是在测试或Beta阶段,开发者可能会不慎引用到领英内部或实验性的API端点,例如https://api.linkedin-ei.com/v2/videos?action=finalizeUpload。
linkedin-ei.com域名通常指向内部测试或开发环境,其行为可能与生产环境(api.linkedin.com)不一致,或者根本不对外部请求开放。当initializeUpload请求可能被正确路由到生产环境,而finalizeUpload请求却被发送到错误的内部端点时,服务器就会因为无法处理请求或请求被拒绝而返回500(内部服务器错误)或504(网关超时)错误。
解决此问题的关键是确保所有API请求,特别是finalizeUpload,都指向正确的生产环境API端点:https://api.linkedin.com/v2/videos?action=finalizeUpload。
以下是基于PHP的示例代码,展示了如何修正finalizeUpload的API端点:
<?php
// 假设 $client 是一个已经配置好的HTTP客户端实例 (例如 Guzzle)
// 并且已经处理了认证等前置步骤
// $client = new GuzzleHttp\Client([...]);
$userUrn = 'urn:li:person:[your_user_urn]'; // 替换为你的用户URN
$videoFile = '/path/to/your/video.mp4'; // 替换为你的视频文件路径
// 1. 初始化上传请求
// 此处的initializeUpload端点通常是正确的,因为它能返回上传指令
$registerResult = $client->post(
'https://api.linkedin.com/v2/videos?action=initializeUpload', // 确保使用正确的初始化端点
[
"json" => [ // Guzzle通常使用'json'来发送JSON数据
"initializeUploadRequest" => [
'owner' => $userUrn,
"purpose" => 'FEED_VIDEO',
"fileSizeBytes" => filesize($videoFile),
"uploadCaptions" => false,
"uploadThumbnail" => false
]
]
]
);
$videoUrn = $registerResult['value']['video'];
$uploadToken = $registerResult['value']['uploadToken'] ?? ''; // uploadToken可能为空
$uploadInstructions = $registerResult['value']['uploadInstructions'];
// 2. 分块上传视频
// 假设视频文件已按4MB左右分块,并存储在临时文件中(如xaa, xab等)
// 实际应用中,建议使用更健壮的文件处理和HTTP客户端上传方式
$etags = [];
$partCounter = 0;
foreach ($uploadInstructions as $instruction) {
$filePath = __DIR__ . '/x' . chr(ord('a') + $partCounter); // 示例文件名 xaa, xab...
if (!file_exists($filePath)) {
// 实际应用中需要确保分块文件存在
throw new Exception("Video part file not found: " . $filePath);
}
// 使用curl命令上传分块文件,并提取Etag
// 在生产环境中,建议使用HTTP客户端库的流式上传功能
$shellCmd = 'curl -v -H "Content-Type:application/octet-stream" --upload-file "' . $filePath . '" "' . $instruction['uploadUrl'] . '" 2>&1';
exec($shellCmd, $output);
$matches = [];
preg_match('/(etag:)(\s?)(.*)(\n)/i', implode("\n", $output), $matches);
if (isset($matches[3])) {
$etags[] = trim($matches[3]);
} else {
// 处理Etag未找到的情况
throw new Exception("Could not retrieve Etag for part " . $partCounter);
}
$partCounter++;
}
// 清理临时分块文件 (根据实际需求决定是否保留)
exec("rm xa*");
// 3. 终结上传请求 (核心修正点)
// **将错误的 api.linkedin-ei.com 替换为正确的 api.linkedin.com**
$videoStatus = $client->post(
"https://api.linkedin.com/v2/videos?action=finalizeUpload", // **修正后的正确端点**
[
"json" => [
"finalizeUploadRequest" => [
"video" => $videoUrn,
"uploadToken" => $uploadToken,
"uploadedPartIds" => $etags
]
]
]
);
// 检查上传结果
if ($videoStatus->getStatusCode() === 200) {
echo "视频上传成功,状态: " . json_encode($videoStatus->json()) . "\n";
} else {
echo "视频上传终结失败,状态码: " . $videoStatus->getStatusCode() . ",响应: " . $videoStatus->getBody()->getContents() . "\n";
}
?>关键修改点: 将$client-youjiankuohaophpcnpost("videos?action=finalizeUpload", ...) 或 https://api.linkedin-ei.com/v2/videos?action=finalizeUpload 更改为: "https://api.linkedin.com/v2/videos?action=finalizeUpload"
当领英视频API的finalizeUpload操作返回500或504错误时,一个常见但容易被忽视的原因是使用了错误的API端点URL。通过将API请求指向正确的生产环境端点https://api.linkedin.com/v2/videos?action=finalizeUpload,可以有效解决此问题。开发者在集成API时,务必仔细核对官方文档,确保所有请求都使用正确的URL,并结合健壮的错误处理机制和现代HTTP客户端库,以构建稳定可靠的视频上传解决方案。
以上就是解决领英视频API上传终结时500/504错误:API端点URL修正指南的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号