Skip to content

在线调试面板 ​

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

接口详情页右侧的在线调试面板

面板组成 ​

区域作用
API Key(可选)全站通用的身份参数输入框,不属于接口业务参数
请求参数按接口参数表自动生成输入项,枚举值会做成下拉框
请求 URL根据当前填写内容实时拼出的完整地址
发送请求 / 重置 / 复制 URL发起试调、清空、复制地址
返回结果显示真实响应,可切「美化打印」查看格式化 JSON

使用步骤 ​

  1. 打开任一接口详情页,例如 临时邮箱。
  2. 在「请求参数」里填值。以临时邮箱为例,action 选 create 时不需要其他参数。
  3. 点「发送请求」,下方会展示本次真实返回。
  4. 点「复制 URL」,把地址贴进自己的代码或 curl。

参数表里为什么没有 key

key 是全站通用的身份参数,不是某个接口的业务参数。面板把它单独放在顶部,避免每个接口都重复列一行。需要时填进去,面板会在拼接 URL 时自动带上。详见 鉴权与 API Key。

用面板定位问题 ​

面板能跑通、你的代码跑不通,通常只有三种原因:

  • URL 编码:中文、空格、&、# 没编码,参数被截断。见 参数与编码。
  • 方法或参数名:把 GET 写成 POST 表单,或参数名大小写拼错。
  • Key 传递方式:代码里没带 key,或带了多余的空格。

面板跑不通、且返回 502 / 503,多半是上游数据源或服务端临时问题,稍后重试即可,见 响应格式与错误码。

多步接口怎么调 ​

像 临时邮箱 这类接口需要多步:

  1. action=create → 从返回里拿到 token。
  2. 把 token 填进 token 输入框,action 选 list → 拿到邮件 id。
  3. 再填 id,action 选 read → 读正文。

每一步的返回都留在面板里,可以直接对照字段。

接口数据实时读取自站点数据库