DeepSeek怎么根据接口文档写代码？

先说说我的一个核心判断。DeepSeek-R1确实能根据OpenAPI 3.0文档，直接帮你生成Python调用代码，省去手动逐行翻译字段和请求逻辑的繁琐步骤。但问题在于，它生成的代码往往只是半成品——Bearer鉴权、环境变量读取以及自动重登录逻辑，还是得自己动手补上，最后才能封装成一个支持token刷新的Client类。

说白了，你需要把一份OpenAPI 3.0格式的接口文档（比如swagger.json或yaml文件）喂给DeepSeek，让它生成可运行的代码，而不是自己一行一行地翻译接口。

准备接口文档文件

首先，你得确保手头有一份结构完整的OpenAPI 3.0规范文档，扩展名是.json或.yaml。如果用的是网页版Swagger UI，直接点击右上角那个「Download spec」按钮，下载原始JSON文件——

，否则路径、参数和响应结构的信息会丢失，DeepSeek根本没法解析。

下载后，把文件重命名为api_spec.json，放在当前工作目录下就行。

用DeepSeek-R1生成基础调用代码

接下来，打开DeepSeek的正式版或本地部署的R1模型界面，在对话框中粘贴下面的提示词。关键是你得把提示词写对，DeepSeek才能理解你的需求：

“你是一名Python后端工程师。请根据我提供的OpenAPI 3.0 JSON文档，生成一个完整、可直接运行的requests调用示例。要求：①自动识别/auth/login路径的POST请求；②提取所有必需的path、query、body参数并设为变量；③对required字段加注释说明是否必填；④在代码开头写明依赖库和使用方式。”

然后上传api_spec.json文件，点击发送，等着看结果。

检查并修正生成的代码

DeepSeek通常会生成类似这样的代码片段：

```python
import requests

url = "https://api.example.com/v1/auth/login"
headers = {"Content-Type": "application/json"}
data = {"username": "admin", "password": "123456"}
response = requests.post(url, headers=headers, json=data)
```

但这里有个坑：如果文档中定义了securitySchemes为Bearer Token，而DeepSeek没生成鉴权逻辑，

。你得先确认spec里components → securitySchemes → bearerAuth → scheme字段确实是bearer类型，然后手动补上这一行：
headers["Authorization"] = f"Bearer {token}"

另外，硬编码的密码字符串也得删掉，改用os.getenv("API_PASSWORD")读取环境变量——这既是安全习惯，也是代码可维护性的基本要求。

封装成可复用的Client类

有了基础代码，接下来就是把它封装成一个可复用的Client类。这一步才是深度使用的关键。

首先，新建一个client.py文件，定义一个BaseClient类，初始化时接收base_url和access_token两个参数。在__init__方法里，保存self.base_url和self._token，同时设置默认headers，包含Accept: application/json和Authorization字段。

然后，实现一个_login方法，专门用来调用POST /auth/login接口，传入username和password，从响应JSON中提取token并更新self._token。这个逻辑看似简单，但很多新手会忽略。

接着，实现一个_get方法，自动注入Bearer Token，并对401响应触发重新登录逻辑——这一步DeepSeek几乎从不自动生成，必须手写。为什么要这么做？因为token过期后，代码会自动重试登录，然后重新发起请求，整个流程才能无缝衔接。

最后，为每个业务接口（比如GET /users/{id}）单独写一个方法，用f-string拼接path参数，用params字典处理query参数，返回response.json()。这样，整个Client类就完整了，后续调用只需要实例化一次，然后直接调用方法就行。