让 DeepSeek 解释接口测试怎么落地？把响应约定变成可复跑断言

让 DeepSeek 解释接口测试时，要给它完整的成功和失败约定。HTTP通信成功、JSON能解析和业务操作成功是三件不同的事，响应检查必须分别表达。

需要把接口说明转成前端响应检查的新手。本文使用 Python 3.11 或以上版本的标准库，先验证一组人工构造的小样本。AI 负责提出实现或解释差异，结果由本地检查决定；这里没有把模型回答当成真实运行结果。

核对接口响应的字段与失败语义前，先定规则

示例接口响应是status和items，status只能是ok或error。ok表示items为列表，列表为空是“没有记录”；error必须包含非空message，不能被解释成成功。

条目id必须是整数且不能为布尔值。Python里bool是int的子类，单独用isinstance(id,int)会接受True，这是AI生成类型检查常见的细节缺口。

本例不用真实网络，只验证已保存响应样本。把网络状态、响应正文和契约检查分层，便于知道故障发生在哪一步。

给 AI 的输入要包含什么

把下面这份输入说明和你的实际样本一起交给可用的 AI 编程助手。示例只含虚构数据；对真实材料先去除账号凭据和个人信息。

请解释并生成响应检查函数：status=ok时items必须为列表，每项id严格为int不能bool；status=error时message非空字符串并抛业务失败；空items是合法成功。用正常、空列表、id=True、error四份样本，禁止把异常转换为空列表。

要求模型保留检查条件，并把它认为缺少的业务定义列出来。若回答改变了输入字段、忽略异常分支或直接删除原材料，先要求修正，再运行。提示词的作用是缩小任务范围，验收仍以代码和数据为准。

保存并运行最小验证程序

下方程序把关键规则和验证用例放在同一个可复跑示例中，便于先理解输入如何变成输出，再用它检查 AI 给出的实现。

新建一个空目录，把下面代码保存为 check.py，在该目录打开终端，运行 python -X utf8 check.py。代码自带示例输入，不需要安装第三方库。

def validate(data):
    if not isinstance(data,dict): raise ValueError('响应必须是对象')
    if data.get('status')=='error':
        msg=data.get('message')
        if not isinstance(msg,str) or not msg: raise ValueError('失败缺少说明')
        raise ValueError('业务失败: '+msg)
    if data.get('status')!='ok': raise ValueError('未知状态')
    items=data.get('items')
    if not isinstance(items,list): raise ValueError('items类型错误')
    for row in items:
        if not isinstance(row,dict) or type(row.get('id')) is not int:
            raise ValueError('id必须为整数')
    return items
assert validate({'status':'ok','items':[]})==[]
assert validate({'status':'ok','items':[{'id':1}]})==[{'id':1}]
print('valid_and_empty',True)
for sample in [{'status':'ok','items':[{'id':True}]},{'status':'error','message':'expired'}]:
    try: validate(sample)
    except ValueError as e: print('rejected',str(e))
    else: raise AssertionError('错误响应必须失败')

怎样判断结果符合要求

valid_and_empty为True，id=True被拒绝，status=error产生业务失败说明。这个结果只验证响应内容，不证明远端接口认证、分页或网络调用正常。

下方是这份最小示例在本地执行得到的输出。它验证示例程序与断言的关系，不代表任何 AI 模型一次就能生成同样代码，也不构成性能或生产可靠性结论。

valid_and_empty True
rejected id必须为整数
rejected 业务失败: expired

空列表是一个真实数据结果，业务失败是另一条路径。把所有错误转换为[]会让前端误报“没有记录”。

提示词应包含后端已有约定，而不是让模型替你发明status和字段名；这里字段是为说明问题构造的示例。

哪些失败必须停下来处理

真实接口若使用HTTP 4xx/5xx或错误码，依据正式文档调整检查，不套用本例虚构约定。

不要用AI解释代替权限验证。当前用户能否读取id对应记录需要后端鉴权与跨账号测试。

响应新增字段可允许保留，关键字段改名或类型改变应视作契约变更，不能自动猜别名兜底。

接入自己的任务前再核对一次

把脱敏响应保存成固定样本，AI改动前后都运行；同时保留一个真实测试环境的只读调用验证。

前端展示错误时用具体可行动说明，但完整诊断放本地日志；不要把凭据或原始堆栈直接显示给用户。

资料与适用范围

JSON布尔值、数字与对象解码为Python类型，验证业务响应时需要显式检查字段与类型。以下链接核对于 2026-10-03；运行环境及额外依赖按本文前述说明。

• https://docs.python.org/3.11/library/json.html

相关基础可阅读 Cursor 怎么开发后端 API？先定接口契约，再实现和测试。本文的重点是核对接口响应的字段与失败语义，可以把两项检查作为不同步骤保留。