如何通过Zoho CRM API基于Created_Time条件筛选获取记录？

嘿，我看你在Zoho CRM API用Created_Time筛选记录的时候踩坑了——明明实际只有3、4条符合条件的记录，用criteria参数却返回了200条，反而用if-modified-since头能正常工作，这确实挺闹心的。我来帮你拆解下可能的问题和解决办法：

最可能的元凶：URL编码问题 #

你代码里的Created_Time值带了+号（2025-02-25T00:00:00+00:00），当你把这个字符串作为URL参数传递时，requests库或者服务器可能会把+解析成空格，导致Zoho识别的日期变成了2025-02-25T00:00:00 00:00，这完全偏离了你要筛选的时间范围，自然会返回大量不相关的旧记录。

解决办法很简单，手动对日期里的+进行URL编码（换成%2B），或者用Python的urllib.parse.quote()对整个criteria字符串编码，确保Zoho能正确解析时间：

from urllib.parse import quote

# 方式1：手动替换+为%2B
criteria = "(Created_Time:greater_than:2025-02-25T00:00:00%2B00:00)"

# 方式2：用quote自动编码整个criteria（更省心，适合复杂条件）
# criteria = quote("(Created_Time:greater_than:2025-02-25T00:00:00+00:00)")

第二要排查的：时区不匹配 #

登录你的Zoho CRM后台，去系统设置里看看默认时区是什么。比如如果你的CRM用的是东8区（Asia/Shanghai），你传入的UTC时间（+00:00）对应的CRM本地时间是前一天的16点，这时候筛选条件会包含从“前一天16点”到现在的所有记录，可能就会多出很多你以为不符合的旧数据。

解决办法：

• 要么把你要筛选的时间转换成CRM本地时区的时间，比如CRM是东8区，你要筛选2025-02-25 00:00之后的记录，就用2025-02-25T00:00:00+08:00作为条件值；
• 要么直接用CRM时区的日期格式（比如2025-02-25 00:00:00），不带时区，让Zoho自动用系统时区解析。

额外的验证步骤 #

1. 先在CRM后台验证条件：直接在Zoho CRM的Deals模块搜索栏里用同样的条件（比如Created Time > 2025-02-25 00:00:00）搜索，看看返回多少记录。如果后台返回的就是200条，那说明你对“实际只有3、4条符合”的判断有误；如果后台返回3-4条，那肯定是API请求的参数有问题。
2. 检查返回的原始数据：在代码里打印出data的完整内容，看看返回的记录的Created_Time字段值是什么，是不是真的符合你设置的筛选条件，这样能快速定位是筛选条件没生效，还是数据本身的问题。

修改后的完整代码示例 #

import requests
import pandas as pd
from urllib.parse import quote

url = "https://www.zohoapis.com/crm/v2/Deals"  # 替换成你的实际API地址
access_token = "your_actual_access_token"

# 用quote编码criteria，避免+号被错误解析
criteria = quote("(Created_Time:greater_than:2025-02-25T00:00:00+00:00)")

headers = {
    "Authorization": f"Zoho-oauthtoken {access_token}"
}

params = {
    "criteria": criteria
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    
    deals = data.get("data", []) 

    if deals:
        df = pd.DataFrame(deals)
        print(f"Number of records fetched: {len(df)}")
        # 额外打印前几条的Created_Time，验证是否符合条件
        print(df[["Created_Time", "Deal_Name"]].head())
    else:
        print("No records found for the specified Created_Time.")
elif response.status_code == 204:
    print("No content returned for the specified criteria.")
else:
    print(f"Error: {response.status_code} - {response.text}")

备注：内容来源于stack exchange，提问作者Tayyab Vohra