解决LinkedIn视频API上传终结阶段500/504错误：正确端点是关键

LinkedIn视频API上传终结阶段错误解析与解决方案

在使用linkedin视频api（尤其是在其beta阶段）进行视频上传时，开发者可能会遇到一些挑战。其中一个常见且令人困惑的问题是，在分段上传（multipart upload）的所有视频片段似乎都成功上传后，调用finalizeupload端点时却收到500 internal server error或504 gateway timeout错误。尽管开发者可能已仔细遵循文档、确保分段上传正确无误并收集了所有必要的etag，这些错误依然可能发生。

问题背景与常见症状

LinkedIn视频API支持大文件上传，通常需要将视频文件分割成多个小片段进行上传。其基本流程如下：

1. 初始化上传（initializeUpload）: 请求一个视频URN、上传令牌和一系列分段上传URL。
2. 分段上传（Upload Parts）: 将视频文件分割成指定大小的片段，并使用提供的URL逐一上传每个片段，同时记录每个片段的ETag。
3. 终结上传（finalizeUpload）: 将视频URN、上传令牌和所有收集到的ETag发送给API，通知其合并所有片段并完成视频上传。

当开发者在finalizeUpload阶段遇到500 Internal Server Error或504 Gateway Timeout时，通常伴随着以下现象：

• initializeUpload请求成功，返回了视频URN和上传指令。
• 每个视频片段的上传（通常通过curl或其他HTTP客户端）都成功，并返回了有效的ETag。
• 即使增加客户端的请求超时时间，504 Gateway Timeout依然出现，表明问题可能不在客户端超时。
• 500 Internal Server Error则直接指向服务器端处理请求时发生了未预期的错误。

核心问题：API端点混淆

经过深入分析，导致这些500或504错误的核心原因在于finalizeUpload请求使用了错误的API端点。LinkedIn的文档有时可能引用了内部或测试环境的URL，例如https://api.linkedin-ei.com/v2/videos?action=finalizeUpload。然而，对于公共或生产环境的API调用，应使用标准的LinkedIn API端点。

错误的端点示例：https://api.linkedin-ei.com/v2/videos?action=finalizeUpload

正确的端点示例：https://api.linkedin.com/v2/videos?action=finalizeUpload

api.linkedin-ei.com可能是一个内部的“Early Integration”或测试环境的端点，不应在生产或面向公众的集成中使用。当请求发送到这个错误的端点时，即使请求结构和参数正确，服务器也无法正确处理，从而返回500 Internal Server Error或在处理超时后返回504 Gateway Timeout。

BibiGPT-哔哔终结者

B站视频总结器-一键总结 音视频内容

28

查看详情

解决方案

解决此问题的关键是确保在调用finalizeUpload端点时，使用正确的LinkedIn API主域名。

步骤概述：

1. 确认所有前置步骤正确：确保initializeUpload成功，并且所有视频片段都已成功上传，每个片段的ETag都已正确收集。
2. 修改finalizeUpload请求URL：将finalizeUpload请求的目标URL从https://api.linkedin-ei.com/v2/videos?action=finalizeUpload更改为https://api.linkedin.com/v2/videos?action=finalizeUpload。
3. 重新尝试上传：使用修改后的URL再次发送finalizeUpload请求。

示例代码（PHP with Guzzle）

以下是一个使用Guzzle HTTP客户端在PHP中进行finalizeUpload的示例，重点突出正确端点的使用。假设您已经完成了initializeUpload和所有分段上传，并获取了$videoUrn、$uploadToken和$etags数组。

<?php

require 'vendor/autoload.php'; // 引入 Composer 自动加载文件

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

// 假设您已经有一个配置好的 Guzzle 客户端实例
// 确保您的客户端配置了正确的认证头，例如 Authorization: Bearer <YourAccessToken>
$client = new Client([
    'base_uri' => 'https://api.linkedin.com/', // 设置正确的基URI
    'headers' => [
        'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', // 替换为您的实际访问令牌
        'Content-Type' => 'application/json',
        'X-Restli-Protocol-Version' => '2.0.0', // LinkedIn API 版本头
    ],
    'timeout' => 600, // 增加超时时间以应对网络延迟，尽管不是根本原因
]);

// 假设这些变量已从之前的 initializeUpload 和分段上传步骤中获取
$userUrn = 'urn:li:person:YOUR_PERSON_URN'; // 替换为您的用户 URN
$videoUrn = 'urn:li:video:YOUR_VIDEO_URN'; // 从 initializeUpload 响应中获取
$uploadToken = 'YOUR_UPLOAD_TOKEN'; // 从 initializeUpload 响应中获取，可能为空
$etags = [
    'etag_from_part_1',
    'etag_from_part_2',
    // ...所有分段上传返回的 etag
];

echo "准备终结视频上传...\n";

try {
    // 构建 finalizeUpload 请求体
    $finalizePayload = [
        "finalizeUploadRequest" => [
            "video" => $videoUrn,
            "uploadToken" => $uploadToken,
            "uploadedPartIds" => $etags
        ]
    ];

    // 发送 finalizeUpload 请求到正确的端点
    $response = $client->post(
        'v2/videos?action=finalizeUpload', // 使用相对路径，因为 base_uri 已设置
        [
            'json' => $finalizePayload // Guzzle 会自动处理为 JSON
        ]
    );

    // 检查响应状态码
    if ($response->getStatusCode() === 200) {
        $responseData = json_decode($response->getBody()->getContents(), true);
        echo "视频上传终结成功！\n";
        echo "响应数据: " . json_encode($responseData, JSON_PRETTY_PRINT) . "\n";
        // 在这里可以处理成功后的逻辑，例如获取视频状态或后续操作
    } else {
        echo "视频上传终结失败，状态码：" . $response->getStatusCode() . "\n";
        echo "响应内容：" . $response->getBody()->getContents() . "\n";
    }

} catch (RequestException $e) {
    echo "请求异常：\n";
    echo "错误信息: " . $e->getMessage() . "\n";
    if ($e->hasResponse()) {
        echo "响应状态码: " . $e->getResponse()->getStatusCode() . "\n";
        echo "响应内容: " . $e->getResponse()->getBody()->getContents() . "\n";
    }
} catch (\Exception $e) {
    echo "发生未知错误：" . $e->getMessage() . "\n";
}

?>

代码注意事项：

• base_uri 应设置为 https://api.linkedin.com/。
• post 方法的第一个参数应是相对于 base_uri 的路径，即 v2/videos?action=finalizeUpload。
• 确保 Authorization 头包含有效的LinkedIn访问令牌。
• X-Restli-Protocol-Version 头是LinkedIn API要求的。
• 在实际应用中，应替换示例中的占位符（如YOUR_ACCESS_TOKEN, YOUR_PERSON_URN, YOUR_VIDEO_URN, YOUR_UPLOAD_TOKEN）。
• 添加适当的错误处理，以捕获网络问题、API返回的错误等。

总结

当您在LinkedIn视频Beta API的finalizeUpload阶段遇到500 Internal Server Error或504 Gateway Timeout时，首要排查方向应是您所使用的API端点URL。确保您使用的是https://api.linkedin.com/v2/videos?action=finalizeUpload而非任何其他内部或测试端点。虽然API处于Beta阶段可能会有其他潜在问题，但端点错误是一个常见且容易被忽视的根本原因。仔细审查API文档，并严格按照其指示使用正确的生产环境URL，是确保API集成成功的关键。

以上就是解决LinkedIn视频API上传终结阶段500/504错误：正确端点是关键的详细内容，更多请关注php中文网其它相关文章！