API 测试管理：添加接口测试配置教程

网程聚合数据 2026-10-31 05:36 8 阅读新手教程

API 测试管理教程：在用户中心添加接口测试配置并保存参数，反复调试无需重填。含运行会真实扣点、结果查看与任务类接口取结果的方式。

「API测试管理」用于把某个接口的测试参数保存下来，反复调试时不用每次重新填。页面在用户中心「开发者中心」→「API测试管理」，地址 `/member/developer/api-test`。

它与接口文档页的「在线测试」是两套前端、同一条调用链路：文档页适合临时试一次，本页适合长期复用同一组参数。

## 一、页面说明

- **一条配置对应一个接口**：每个账号对同一个接口只能保存一条测试配置，重复添加会提示「该接口已有测试配置」并直接打开已有配置。不同接口可以各存一条，总条数没有上限。
- **不能自定义名称，也没有备注字段**：配置的名字就是接口名称，列表里按接口区分。
- **参数以键值对保存**，保存后下次打开弹窗自动带出，不需要重新填写。
- **列表共 4 列**：接口名称、接口标识、上游通道、操作。操作只有「配置测试参数」与「删除」两个按钮，运行在弹窗里进行。
- **筛选与分页**：顶部可按接口名称、接口标识（`jk_mark`）、上游通道筛选，按钮为「筛选」与「重置」；每页固定 20 条，按最近更新时间倒序排列。没有配置时显示「暂无测试配置，点击下方按钮添加」。
- **前置条件**：必须先在「API密钥设置」页生成 AppKey，否则运行时会提示「请先在 API密钥设置 中生成 API Key」。可添加的接口范围是全部已启用接口，没有额外限制。

## 二、添加接口并填写测试参数

**第 1 步：进入页面。** 登录 <https://www.phpwc.cn/member/login> 后访问 <https://www.phpwc.cn/member/developer/api-test>，或点击左侧菜单「开发者中心」→「API测试管理」。

**第 2 步：在页面底部的「接口标识」框填入 `jk_mark`**（提示文案为「例如：mobile3verify」），点击「添加」。接口标识在接口文档页地址末尾或「API接口列表」里可以查到，输入会自动转成小写。

添加成功后页面**自动弹出「配置测试参数」窗口**；标识写错或接口未启用时提示「未找到接口标识 'xxx'，请检查是否已启用」，留空则提示「请输入接口标识」。

**第 3 步：在弹窗里填参数。** 弹窗顶部「接口名称」与「接口标识」是只读的，下面是「测试参数」区：

- 首次打开时，系统会按该接口定义的请求参数**自动铺出对应的行**，并填上默认值，字段下方显示参数说明，必填参数带红色「必填」标签。
- 每一行左边填「字段名」、右边填「测试值」，行尾的红叉用于删除该行；需要额外参数时点「添加参数」增加一行。
- 参数值一律按文本提交，没有 JSON 编辑器，也不做前端格式校验。嵌套对象或数组参数需要你自己写成合法的 JSON 字符串再填进「测试值」。
- 文件类参数**没有上传控件**，只能填文本：填 `file_url`（公网可访问的文件链接）、`file_base64`（文件的 base64 内容）或 `file_id`（先调用文件上传接口拿到的 ID），三者按接口要求选其一。

**第 4 步：点击「保存配置」。** 提示「保存成功」即写入完成，列表里会出现这条配置。之后再点「配置测试参数」就能看到刚保存的值。

> 「保存配置」与「运行测试」是两个独立动作，**点运行不会自动保存你刚改的参数**。想留到下次用，改完参数请先点一次「保存配置」。

## 三、运行、查看结果与删除

**运行测试**：在弹窗里点「运行测试」，按钮变为「测试中...」并暂时禁用，防止连点。平台会用你自己的 PID 与 AppKey 签名，走与正式调用完全相同的接口链路。

> **运行测试会真实扣点。** 它不是沙箱调用：成功一次就按该接口单价扣一次点数，失败不扣，VIP 免费规则同样适用。本页没有额外的费用提示，请留意自己的点数余额。页面也没有频率与并发限制，不要连续高频点击。

**查看结果**：结果出现在弹窗下方的「响应结果」区，以格式化 JSON 显示接口返回原文，右上角「复制」按钮可一键复制（点击后短暂变为「已复制」），结果区会自动滚动到视野内。调用失败时同一区域显示返回的错误码与描述。

**弹窗里不显示耗时、消耗点数与追踪ID**。需要这些信息时，到「开发者中心」→「接口调用记录」（`/member/developer/call-log`）按接口标识或追踪ID 查找本次调用，那里可以看到消耗点数、点数状态、耗时与请求响应原文。

**任务类接口怎么拿结果**：文档转换、文档翻译等任务类接口提交后只返回 `task_id`，本页**没有自动轮询功能**。要取结果，再添加一条 `taskresult`（任务处理查询）的测试配置，把 `task_id` 或 `serialnumber` 填进去运行；也可以到「任务与附件」→「异步任务列表」查看任务状态与产物下载地址。这类接口还需要先在「参数配置」页配好附件存储凭证，否则会提示先配置存储。

**删除配置**：在列表里点该行的「删除」，确认框提示「确定删除 "接口名" 的测试配置？」，确认后整页刷新，该条配置移除。删除只影响你保存的测试参数，不影响接口本身，也不会删除历史调用记录。

> 选择建议：只想临时看一眼某个接口的返回，用接口文档页的「在线测试」选项卡更快（字段已固定渲染，按钮为「发起测试」，旁边明确标注会真实扣点，但参数不保存）；需要反复用同一组参数调试，就用本页保存配置。

常见问题

Q：同一个接口可以保存多组测试参数吗？能给配置起名字吗？

A：不可以。每个账号对同一个接口只能保存一条测试配置，重复添加会提示该接口已有测试配置并直接打开已有配置；不同接口可以各存一条，总条数没有上限。配置的名字固定为接口名称，不能自定义，也没有备注字段，列表里按接口名称、接口标识与上游通道区分。

Q：运行测试会扣点数吗？参数要先保存再运行吗？

A：会真实扣点。运行测试走的是与正式调用完全相同的接口链路，用你自己的 PID 与 AppKey 签名，成功一次就按该接口单价扣一次点数，失败不扣，VIP 免费规则同样适用，本页没有额外的费用提示。保存配置与运行测试是两个独立动作，点运行不会自动保存刚改的参数，想留到下次用请先点一次保存配置。

Q：任务类接口在这里怎么拿到最终结果？

A：文档转换、文档翻译等任务类接口提交后只返回 task_id，本页没有自动轮询功能。要取结果，再添加一条 taskresult（任务处理查询）的测试配置，把 task_id 或 serialnumber 填进去运行；也可以到任务与附件下的异步任务列表查看任务状态与产物下载地址。这类接口还需要先在参数配置页配好附件存储凭证，否则会提示先配置存储。

新手教程用户中心接口测试 API密钥按次计费

上一篇：VIP 套餐购买与权益说明教程下一篇：没有了

网友评论（0）

暂无评论，快来抢沙发～