使用Python调用Cloudflare v4 API更新DNS记录时遇400请求体无效错误

核心问题：请求体格式不匹配 #

你的代码中已经指定了Content-Type: application/json，但调用requests.patch时使用了data=data参数——这个参数会把字典编码为表单格式（application/x-www-form-urlencoded），而非Cloudflare API要求的JSON格式，导致服务端无法解析请求体，返回9207错误。

修复方案 #

将data=data替换为json=data，requests会自动把字典序列化为JSON字符串，同时匹配你设置的Content-Type头：

import requests

full_api_key = "Bearer " + "API_KEY"
api_url = f"https://api.cloudflare.com/client/v4/zones/ZONE_ID/dns_records/RECORD_ID"
    
headers = {
    'x-auth-email': "EMAIL",
    'Authorization': full_api_key,
    'Content-Type': 'application/json'      
}
    
data = {
    "content": 'NEW_IP',
    "name": 'DOMAIN',
    "proxied": True,
    "type": 'A',
    "comment" : "DNS Record Auto-updated",
    "tags" : [],
    "ttl": 3600,
}

# 替换为json参数传递请求体
res = requests.patch(api_url, headers=headers, json=data)

print(res.json())

额外检查要点 #

• 确认API密钥类型：如果使用的是Global API Key，不需要加Bearer前缀，改用x-auth-key头：

  headers = {
      'x-auth-email': "EMAIL",
      'x-auth-key': "API_KEY",  # 直接填写Global API Key，无需Bearer
      'Content-Type': 'application/json'      
  }
  

• 精简请求体：如果仅需更新IP地址，不需要传递所有字段，只保留content和proxied（如需保留代理状态）即可，降低出错概率：

  data = {
      "content": 'NEW_IP',
      "proxied": True
  }
  

• 再次核对ZONE_ID、RECORD_ID、DOMAIN、NEW_IP的真实值，确保无空格、拼写错误。

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