主题
在线调试面板
每个接口详情页右侧都有调试面板,改参数、试请求、复制地址都在这一处完成,不用自己拼 URL。

面板组成
| 区域 | 作用 |
|---|---|
| API Key(可选) | 全站通用的身份参数输入框,不属于接口业务参数 |
| 请求参数 | 按接口参数表自动生成输入项,枚举值会做成下拉框 |
| 请求 URL | 根据当前填写内容实时拼出的完整地址 |
| 发送请求 / 重置 / 复制 URL | 发起试调、清空、复制地址 |
| 返回结果 | 显示真实响应,可切「美化打印」查看格式化 JSON |
使用步骤
- 打开任一接口详情页,例如 临时邮箱。
- 在「请求参数」里填值。以临时邮箱为例,
action选create时不需要其他参数。 - 点「发送请求」,下方会展示本次真实返回。
- 点「复制 URL」,把地址贴进自己的代码或 curl。
参数表里为什么没有 key
key 是全站通用的身份参数,不是某个接口的业务参数。面板把它单独放在顶部,避免每个接口都重复列一行。需要时填进去,面板会在拼接 URL 时自动带上。详见 鉴权与 API Key。
用面板定位问题
面板能跑通、你的代码跑不通,通常只有三种原因:
- URL 编码:中文、空格、
&、#没编码,参数被截断。见 参数与编码。 - 方法或参数名:把
GET写成 POST 表单,或参数名大小写拼错。 - Key 传递方式:代码里没带
key,或带了多余的空格。
面板跑不通、且返回 502 / 503,多半是上游数据源或服务端临时问题,稍后重试即可,见 响应格式与错误码。
多步接口怎么调
像 临时邮箱 这类接口需要多步:
action=create→ 从返回里拿到token。- 把
token填进token输入框,action选list→ 拿到邮件id。 - 再填
id,action选read→ 读正文。
每一步的返回都留在面板里,可以直接对照字段。