第三方视频接口强制使用OAuth 2.0，PHP需手动实现授权码流程、token刷新、multipart上传及严格校验redirect_uri与字段名。
第三方视频接口通常要求 OAuth 2.0 授权，PHP 必须手动处理 token 刷新
绝大多数主流视频平台（如 YouTube、Bilibili 开放平台、腾讯云 VOD）不再支持简单 API Key 调用，而是强制使用 OAuth 2.0。PHP 本身不内置 OAuth 流程，curl 或 file_get_contents 都无法自动维护 access_token 和 refresh_token 生命周期。
- 必须自己实现授权码模式（Authorization Code Flow）：用户跳转到平台授权页 → 回调接收
code→ 用code换取access_token -
access_token通常 1–2 小时过期，不能硬编码或写死在配置里；需持久化存储（如数据库或 Redis），并在每次请求前检查有效期 - 刷新时要用
refresh_token+client_id+client_secret向https://xxx.com/oauth/token发 POST 请求，响应是 JSON，需解析并更新本地存储 - 常见错误：
invalid_grant（refresh_token已被使用过一次，多数平台只允许单次使用）、invalid_client（client_id或client_secret错误，注意 URL 编码）
上传视频文件必须用 multipart/form-data，且 PHP 的 curl 需显式构造 boundary
直接 curl_setopt($ch, CURLOPT_POSTFIELDS, $data) 传数组会触发 PHP 自动 multipart，但第三方接口（如 YouTube Data API v3 的 videos.insert）往往要求精确控制字段顺序、额外 header（如 Content-Transfer-Encoding: binary）或分块上传策略，此时自动 multipart 不可靠。
- 推荐用
cURLFile类（PHP ≥ 5.5）：确保upload.php中的$_FILES可被正确识别，且服务端未禁用curl_file_create() - 若需分片上传（如大视频 > 100MB），必须按平台协议实现「初始化上传 → 分片 PUT → 合并提交」三步，不能依赖单次
POST - 常见错误：
400 Bad Request（Content-Type缺失或格式不对）、413 Payload Too Large（Nginx/Apache 限制了client_max_body_size或post_max_size）
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $access_token,
'Content-Type: multipart/related; boundary="boundary_123"'
]);
$post_data = "--boundary_123\r\n" .
"Content-Type: application/json; charset=UTF-8\r\n\r\n" .
json_encode($metadata) . "\r\n" .
"--boundary_123\r\n" .
"Content-Type: video/mp4\r\n" .
"Content-Transfer-Encoding: binary\r\n\r\n";
$post_data .= file_get_contents('/path/to/video.mp4');
$post_data .= "\r\n--boundary_123--";
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
回调地址（redirect_uri）必须与平台后台注册的完全一致，包括末尾斜杠和协议
OAuth 第三方登录流程中，redirect_uri 是校验最严格的参数之一。哪怕只是少一个 / 或写成 http 而非 https，平台都会拒绝返回 code，并返回 redirect_uri_mismatch 错误。
- 在平台开放后台填写的
redirect_uri必须和 PHP 构造授权链接时传入的值逐字符相同 - 不要用
$_SERVER['HTTP_HOST']动态拼接 —— 容易漏掉端口（如:8080）或 HTTPS 代理头导致协议误判 - 调试时可先固定写死（如
https://example.com/callback.php），上线后再统一配置为环境变量 - 某些平台（如 Bilibili）还要求
redirect_uri必须是备案域名，测试阶段可用 localhost 但需提前白名单
视频元数据字段名和类型严格匹配文档，PHP 数组键名大小写敏感
例如 YouTube API 要求标题字段是 snippet.title，而 Bilibili 是 title；有些平台要求 privacyStatus 值只能是 public / private / unlisted 字符串，传布尔值或数字会直接报错。
立即学习“PHP免费学习笔记（深入）”；
- PHP 关联数组键名区分大小写：
['privacyStatus' => 'public']≠['privacystatus' => 'public'] - 时间字段（如
publishedAt）必须是 ISO 8601 格式字符串（2024-05-20T12:00:00Z），不能传DateTime对象或时间戳 - 标签（
tags）必须是字符串数组，不能是逗号分隔的字符串；空数组可传，但传null或缺失字段可能被平台拒绝 - 常见错误：
400 Invalid request响应体里带"fieldViolations"，说明某个字段名拼错或类型不符
真正卡住人的，往往是字段名大小写、redirect_uri 多一个空格、token 过期后没重刷却还拿旧值去请求 —— 这些细节不会报错语法，但会让整个流程静默失败。
