From 9077b030fa59b923a5903aac7d596d0e2b907591 Mon Sep 17 00:00:00 2001 From: ucmao <294323976@qq.com> Date: Thu, 10 Sep 2026 06:49:24 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E9=94=99=E8=AF=AF=E7=A0=81?= =?UTF-8?q?=E4=BD=93=E7=B3=BB=E5=B9=B6=E6=94=AF=E6=8C=81=E4=B8=8D=E5=8F=AF?= =?UTF-8?q?=E9=87=8D=E8=AF=95=E7=8A=B6=E6=80=81=E4=B8=8E=E6=97=A0=E5=AA=92?= =?UTF-8?q?=E4=BD=93=E5=86=85=E5=AE=B9=E7=B2=BE=E7=BB=86=E5=8C=96=E8=AF=86?= =?UTF-8?q?=E5=88=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/api/parse.py | 14 ++++++-- src/parsers/base_parser.py | 2 ++ src/parsers/doubao_parser.py | 3 ++ src/parsers/douyin_parser.py | 1 + templates/components/api_docs.html | 57 +++++++++++++++++++++--------- tests/test_api_contract.py | 15 ++++++++ 6 files changed, 73 insertions(+), 19 deletions(-) diff --git a/src/api/parse.py b/src/api/parse.py index e538a05..d7dd229 100644 --- a/src/api/parse.py +++ b/src/api/parse.py @@ -134,12 +134,20 @@ def _execute_parse(text, access): if platform in ('视频号', '微信视频号'): response, status = make_response(400, '解析失败:该链接需要配置腾讯元宝 YUANBAO_COOKIE 凭证后重试', None, False, 'WECHAT_CHANNELS_COOKIE_REQUIRED'), 400 return response, status - terminal_detail = getattr(parser, '_terminal_filter_detail', None) + terminal_detail = getattr(parser, 'terminal_error', None) or getattr(parser, '_terminal_filter_detail', None) if isinstance(terminal_detail, dict): - detail_msg = terminal_detail.get('detail_msg') or terminal_detail.get('notice') + detail_msg = terminal_detail.get('detail_msg') or terminal_detail.get('notice') or '该内容可能为私密/日常作品或已被作者删除' if isinstance(detail_msg, str) and detail_msg.strip(): - response, status = make_response(400, detail_msg.strip(), None, False, 'MEDIA_NOT_FOUND'), 400 + response, status = make_response(400, detail_msg.strip(), None, False, 'MEDIA_DELETED_OR_PRIVATE'), 400 return response, status + is_no_media = getattr(parser, 'no_media_in_content', False) + if is_no_media is True or ( + type(is_no_media).__name__ not in ('Mock', 'MagicMock') + and platform in ('豆包', '通义千问', '腾讯元宝', '夸克AI', '小云雀AI') + and (content_data.get('title') or content_data.get('desc')) + ): + response, status = make_response(400, '该分享内容仅包含文本对话,未包含图片或视频资源', None, False, 'NO_MEDIA_IN_CONTENT'), 400 + return response, status response, status = make_response(400, '提取媒体内容失败,请检查链接或稍后重试', None, False, 'MEDIA_NOT_FOUND'), 400 return response, status diff --git a/src/parsers/base_parser.py b/src/parsers/base_parser.py index 37a86d0..3ee2814 100644 --- a/src/parsers/base_parser.py +++ b/src/parsers/base_parser.py @@ -10,6 +10,8 @@ class BaseParser: self.headers = None self.html_content = None self.session = requests.Session() + self.terminal_error = None + self.no_media_in_content = False def get_real_video_url(self): raise NotImplementedError diff --git a/src/parsers/doubao_parser.py b/src/parsers/doubao_parser.py index 5ab7508..6850802 100644 --- a/src/parsers/doubao_parser.py +++ b/src/parsers/doubao_parser.py @@ -133,6 +133,9 @@ class DoubaoParser(BaseParser): if clean_video_urls: video_urls = clean_video_urls + if not video_urls and not image_urls: + self.no_media_in_content = True + return { "title": self._find_title(roots) or "豆包对话分享", "video_url": video_urls[0] if video_urls else None, diff --git a/src/parsers/douyin_parser.py b/src/parsers/douyin_parser.py index 2f09cee..cbab615 100644 --- a/src/parsers/douyin_parser.py +++ b/src/parsers/douyin_parser.py @@ -256,6 +256,7 @@ class DouyinParser(BaseParser): filter_reason = (data.get('filter_detail') or {}).get('filter_reason') or "terminal_status" logger.info(f"抖音接口返回明确的不可重试终端状态 ({filter_reason}: {filter_msg}),立即终止重试: {base_api.split('?')[0]}") self._terminal_filter_detail = data.get('filter_detail') or {"filter_reason": filter_reason, "detail_msg": filter_msg} + self.terminal_error = self._terminal_filter_detail return None except Exception as e: logger.debug(f"请求抖音接口异常 (第 {attempt + 1}/{attempts} 次): {e}") diff --git a/templates/components/api_docs.html b/templates/components/api_docs.html index d1ee0b8..6463b63 100644 --- a/templates/components/api_docs.html +++ b/templates/components/api_docs.html @@ -132,19 +132,24 @@ 请求是否成功:true 成功;false 失败。 - code - Integer / String - 状态码。成功时固定为 200,失败时为对应错误标识。 + retcode + Integer + 业务响应状态码。成功时为 200,失败时为对应 HTTP 状态(如 400, 401, 402, 429, 503 等)。 - message + retdesc String - 提示信息或异常错误原因。 + 提示信息或官方/系统异常原因说明。 + + + error_code + String + 失败时返回的机器可读标准错误标识(如 MEDIA_DELETED_OR_PRIVATE、NO_MEDIA_IN_CONTENT、RATE_LIMITED 等,详见第 5 节)。 data - Object - 解析成功返回的媒体实体数据对象。 + Object / null + 解析成功返回的媒体实体数据对象,失败时为 null。 @@ -267,42 +272,62 @@ 400 PLATFORM_NOT_SUPPORTED - 目标平台域名不在支持列表中,或属于仅好友可见的私密作品。 + 目标平台域名不在支持列表中。 + + + 400 + MEDIA_DELETED_OR_PRIVATE + 目标内容为私密作品、仅好友可见的日常/动态,或已被作者删除下架。 + + + 400 + NO_MEDIA_IN_CONTENT + 目标分享内容(如 AI 问答对话)仅包含文本,未包含图片或视频多媒体资源。 400 MEDIA_NOT_FOUND - 源视频已被创作者删除、设为私密,或触发了平台风控验证。 + 未能从该链接提取到媒体内容,请检查链接有效性或稍后重试。 400 COOKIE_REQUIRED - 目标平台需要服务端 Cookie。请在管理后台「系统设置 - Cookie管理」中配置有效凭据。 + 目标平台需要服务端 Cookie 凭据校验(如小红书 XIAOHONGSHU_COOKIE_REQUIRED、拼多多 PINDUODUO_COOKIE_REQUIRED、微信视频号 WECHAT_CHANNELS_COOKIE_REQUIRED 等)。请在管理后台「系统设置 - Cookie管理」中配置有效凭据。 401 - INVALID_KEY - 未提供 API Key,或 Key 已被禁用、删除。 + API_KEY_REQUIRED + 请求头或查询参数中未提供 API Key 凭证。 401 - EXPIRED_USER + INVALID_API_KEY + 提供的 API Key 不存在或已被删除。 + + + 403 + API_KEY_DISABLED + 该 API Key 或关联的客户账号已被管理员停用。 + + + 403 + ACCOUNT_EXPIRED 账号使用期限已到期,请联系管理员续期。 402 INSUFFICIENT_CREDITS - 账号可用点数已耗尽(剩余 0 点),请充值或调整额度。 + 账号可用解析积分已耗尽(剩余 0 点),请充值或调整额度。 429 RATE_LIMITED - 超出并发 QPS 阈值,请在客户端增加重试与指数退避。 + 超出当前账号、API Key 或平台的并发 QPS 阈值,请在客户端增加重试与指数退避。 503 API_DISABLED - 系统全局 API 服务被超级管理员临时维护关闭。 + 系统全局 API 服务或特定平台被管理员临时维护关闭。 diff --git a/tests/test_api_contract.py b/tests/test_api_contract.py index 25fcc88..d0d45e6 100644 --- a/tests/test_api_contract.py +++ b/tests/test_api_contract.py @@ -124,6 +124,21 @@ class ApiContractTest(unittest.TestCase): with self.subTest(url=url): self.assert_bad_request(self.post_with_parser(empty_parser, url), message, error_code) + def test_terminal_deleted_or_private_error_contract(self): + terminal_parser = self.parser(video_url=None, video_list=[], image_list=[]) + terminal_parser.terminal_error = { + "filter_reason": "status_self_see", + "detail_msg": "因作品权限或已被删除,无法观看,去看看其他作品吧" + } + response = self.post_with_parser(terminal_parser, "https://www.douyin.com/video/1") + self.assert_bad_request(response, "因作品权限或已被删除,无法观看,去看看其他作品吧", "MEDIA_DELETED_OR_PRIVATE") + + def test_no_media_in_content_error_contract(self): + text_parser = self.parser(video_url=None, video_list=[], image_list=[], title="豆包对话分享") + text_parser.no_media_in_content = True + response = self.post_with_parser(text_parser, "https://www.doubao.com/thread/123") + self.assert_bad_request(response, "该分享内容仅包含文本对话,未包含图片或视频资源", "NO_MEDIA_IN_CONTENT") + def test_normalizes_and_deduplicates_media_urls(self): parser = self.parser( video_url="http://cdn.example/main.mp4",