如何在API请求URL中高效忽略可选查询字段？

1. 不存在通用符号让API忽略字段 #

没有像&那样的通用符号能让所有API自动忽略某个参数。不同API的参数解析逻辑是自定义的：有的可能接受sex=（空值）并忽略，但有的会直接报错。由于你无法修改API内部逻辑，依赖这种方式风险极高，不建议使用。

2. 用requests的params参数简化代码 #

这是处理多可选字段最高效的方案——requests.get()的params参数支持传入字典，会自动过滤值为None的键，帮你自动拼接合法的URL，完全不用写一堆判断语句。

示例1：两个字段的情况 #

import requests

def testUserQuery(user_age, user_sex=None):
    params = {
        'age': user_age,
        'sex': user_sex
    }
    # 自动忽略值为None的参数，生成对应URL
    response = requests.get('https://test-api.com/users', params=params)
    # 测试时可打印URL验证：testUserQuery(17) 会输出 https://test-api.com/users?age=17
    # print(response.url)

test_query = testUserQuery(17)
test_query = testUserQuery(17, 'M')

示例2：扩展到10个可选字段的情况 #

如果有大量可选字段，直接把参数加入字典即可，无需额外判断：

import requests

def testUserQuery(user_age, user_sex=None, user_city=None, user_job=None, user_email=None):
    params = {
        'age': user_age,
        'sex': user_sex,
        'city': user_city,
        'job': user_job,
        'email': user_email
        # 其他可选字段继续添加即可
    }
    response = requests.get('https://test-api.com/users', params=params)

# 调用时只需传必填项和需要的可选字段
test_query = testUserQuery(17, user_city='Beijing')
test_query = testUserQuery(20, user_job='Engineer')

进阶优化：用**kwargs灵活接收参数 #

如果可选字段数量不确定，用**kwargs可以让函数更灵活：

import requests

def testUserQuery(user_age, **kwargs):
    params = {'age': user_age}
    # 过滤掉值为None的可选参数，合并到参数字典
    params.update({k: v for k, v in kwargs.items() if v is not None})
    response = requests.get('https://test-api.com/users', params=params)

# 调用时自由组合参数
test_query = testUserQuery(17, sex='M', city='Shanghai')
test_query = testUserQuery(25, email='test@example.com')

3. 手动构建查询字符串的替代方案 #

如果不想依赖requests的params，可以用urllib.parse.urlencode手动处理：

import requests
from urllib.parse import urlencode

def testUserQuery(user_age, user_sex=None):
    params = {
        'age': user_age,
        'sex': user_sex
    }
    # 过滤值为None的参数
    filtered_params = {k: v for k, v in params.items() if v is not None}
    # 编码为合法的查询字符串
    query_string = urlencode(filtered_params)
    url = f'https://test-api.com/users?{query_string}'
    response = requests.get(url)

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