使用clickuppython调用ClickUp API遇priority非整数验证错误求解决方案

clickuppython库的Tasks模型把priority字段定义成了整数类型，但实际上ClickUp API返回的priority是一个包含id、priority名称等属性的JSON对象，类型不匹配导致Pydantic验证失败。

方案1：临时修改库的模型文件（快速解决） #

找到你的conda环境中clickuppython的models.py文件（路径：C:\Users\x\.conda\envs\general\lib\site-packages\clickupython\models.py），找到定义priority字段的地方，调整类型适配API返回格式：

• 方法A：兼容整数和字典类型

# 找到对应字段定义，修改为：
from typing import Union, Dict, Optional

priority: Optional[Union[int, Dict]] = None

• 方法B：自动提取字典中的id转为整数

from pydantic import validator
from typing import Optional

class Task(BaseModel):
    # 保留其他原有字段
    priority: Optional[int] = None

    @validator('priority', pre=True)
    def parse_priority(cls, v):
        if isinstance(v, dict):
            return int(v.get('id'))
        return v

⚠️ 注意：这种修改会在库版本更新后被覆盖，需要重新调整。

方案2：绕过库的模型验证，直接处理原始响应 #

不依赖库的封装方法，自己用请求工具调用API并处理返回数据：

import requests

API_KEY = "你的API密钥"
LIST_ID = "目标列表ID"

url = f"https://api.clickup.com/api/v2/list/{LIST_ID}/tasks?include_closed=true"
headers = {"Authorization": API_KEY}

response = requests.get(url, headers=headers)
tasks_data = response.json()

# 手动处理优先级数据
for task in tasks_data['tasks']:
    priority_info = task.get('priority')
    priority_id = int(priority_info['id']) if priority_info else None
    print(f"任务名：{task['name']}，优先级ID：{priority_id}")

方案3：向库提交修复请求 #

前往clickuppython的代码仓库提交Issue，说明API返回的priority是对象而非整数的问题，请求作者更新模型适配实际返回格式；如果有能力，也可以直接提交PR修复该问题。

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