<think>我们使用Python的requests库来编写一个通用的HTTPS接口调用函数。这个函数将支持常见的HTTP方法（如GET、POST等），并允许传递参数、头信息、超时设置等。 考虑到HTTPS，我们还需要处理SSL证书验证的问题。默认情况下，我们会验证SSL证书，但也可以根据用户需求关闭验证（虽然不推荐）。 函数设计： 1. 方法（method）：如'GET', 'POST', 'PUT', 'DELETE'等 2. URL（url）：请求的地址 3. 参数（params）：用于GET请求的查询参数 4. 数据（data）：用于POST、PUT等请求的表单数据 5. JSON数据（json）：用于POST、PUT等请求的JSON数据 6. 头信息（headers） 7. 超时时间（timeout） 8. 是否验证SSL证书（verify）：默认为True，若为False则不验证（存在安全风险） 9. 代理（proxies）：可选 10. 其他可能的关键字参数（kwargs）可以传递给requests.request 我们将使用requests.request方法，它能够根据传入的方法进行请求。 注意：同时传递data和json是不被建议的，因为json参数会覆盖data参数（实际上，如果同时传递，json参数会将数据编码为JSON并设置Content-Type为application/json，而data则用于表单数据）。我们这里按照requests库的规则，让调用者自行选择。 返回响应对象，但通常我们可能希望返回响应内容或者状态码等。这里我们可以返回整个响应对象，或者根据需求返回文本、JSON等。但为了通用性，我们返回响应对象，让调用者处理。 但是，为了使其更通用，我们可以提供一个选项，让用户决定返回什么。不过根据要求，我们只写一个通用接口，所以返回整个响应对象，调用者可以通过这个对象获取状态码、内容等。 然而，考虑到错误处理，我们可能会遇到网络错误（如超时、连接错误等），我们可以在函数内部捕获异常并返回None或者抛出异常？这里我们选择抛出异常，因为调用者需要知道请求失败的原因。 但根据通用性，我们可以让调用者自己捕获异常，或者我们提供一个参数来控制是否抛出异常。但是为了简单，我们在这个函数中不捕获异常，让调用者处理。 因此，我们编写如下函数： </think> 以下是一个通用的 Python HTTPS 接口调用函数，使用 `requests` 库实现，支持 GET/POST/PUT/DELETE 方法，包含超时控制、错误处理和基础认证功能： ```python import requests from requests.auth import HTTPBasicAuth def call_https_api( url: str, method: str = 'GET', headers: dict = None, params: dict = None, data: dict = None, json: dict = None, timeout: int = 10, verify_ssl: bool = True, auth: tuple = None ) -> requests.Response: """ 通用HTTPS接口调用函数 参数: url: 请求地址 (必需) method: HTTP方法 (GET/POST/PUT/DELETE) 默认GET headers: 请求头 (字典) params: URL查询参数 (字典) data: 表单数据 (字典) json: JSON请求体 (字典) timeout: 超时时间(秒) 默认10 verify_ssl: SSL证书验证 默认True auth: 基础认证 (username, password) 元组 返回: requests.Response 对象 """ methods = {'GET', 'POST', 'PUT', 'DELETE'} if method.upper() not in methods: raise ValueError(f"无效的HTTP方法，请使用: {', '.join(methods)}") try: # 处理基础认证 auth_obj = HTTPBasicAuth(*auth) if auth else None response = requests.request( method=method.upper(), url=url, headers=headers, params=params, data=data, json=json, timeout=timeout, verify=verify_ssl, auth=auth_obj ) response.raise_for_status() # 自动抛出HTTP错误 return response except requests.exceptions.RequestException as e: # 处理所有requests异常 error_msg = f"接口调用失败: {type(e).__name__}" if hasattr(e, 'response') and e.response is not None: error_msg += f" | 状态码: {e.response.status_code}" try: error_msg += f" | 响应: {e.response.text[:200]}" except: pass raise ConnectionError(error_msg) from e # ======== 使用示例 ======== if __name__ == "__main__": try: # GET请求示例 resp = call_https_api( url="https://jsonplaceholder.typicode.com/posts/1", method="GET", timeout=5 ) print(f"GET请求成功: 状态码 {resp.status_code}") print(resp.json()) # POST请求示例 resp = call_https_api( url="https://jsonplaceholder.typicode.com/posts", method="POST", json={"title": "foo", "body": "bar", "userId": 1}, headers={"Content-Type": "application/json"}, auth=("username", "password") # 基础认证 ) print(f"POST请求成功: 状态码 {resp.status_code}") except Exception as e: print(f"请求异常: {str(e)}") ``` ### 功能特点： 1. **多方法支持**：GET/POST/PUT/DELETE 2. **参数化设计**： - `params`：URL查询参数（GET） - `data`：表单格式数据（POST） - `json`：JSON格式请求体 3. **安全控制**： - SSL证书验证（`verify_ssl`） - HTTP基础认证（`auth`） 4. **健壮性**： - 超时自动终止（`timeout`） - 自动抛出HTTP错误（4xx/5xx） - 统一异常处理（连接错误/超时/SSL错误等） 5. **清晰的错误信息**：包含错误类型、状态码和响应片段 ### 使用场景： - API数据获取（GET） - 表单提交（POST with data） - RESTful API交互（JSON with PUT/DELETE） - 需要基础认证的接口（auth参数）