跳转到内容

快速上手(5 分钟)

目标:从一次全新安装出发,最终得到一个已通过身份验证的请求,其 URL 和令牌都来自变量。 预计需要五分钟。

文件 ▸ 新建Ctrl+N),然后用文件 ▸ 另存为Ctrl+Shift+S) 为它取一个名字,例如 demo.restorm

一个项目就是您磁盘上的一个普通文件。您现在就可以把它放进一个 git 仓库 —— Restorm 正是为此设计的。

在侧边树中右键 ▸ 添加 ▸ 环境文件夹

环境文件夹(也称变量文件夹)是承载您的各个环境(localstagingproduction)以及相应 {{variables}} 的容器。它包含的所有请求都会继承当前选定的环境。

打开它,创建一个 local 环境,并在其中添加一个变量:

类型
baseUrl字符串https://api.exemple.test

某个环境文件夹的标签页,处于“环境”子标签:左侧是选定的环境,右侧是它的 baseUrl 变量

在该文件夹上右键 ▸ 添加 ▸ HTTP 请求。在打开的标签页中:

  • 方法保持为 GET
  • 输入 URL {{baseUrl}}/health —— 解析后的值会显示在输入框下方,这是您的安全网;
  • 点击 Send

响应会在下方展开:状态码、耗时、大小、响应头,以及在可折叠的 JSON 查看器中渲染的正文。

一个 URL 使用了 {{baseUrl}} 的 HTTP 请求,右侧打开了响应面板 —— 状态码、耗时、大小和 JSON 正文

与其硬编码粘贴一个令牌,不如创建一个身份验证请求:右键 ▸ 添加 ▸ 身份验证请求。配置好用于获取令牌的调用(例如一个 POST /oauth/token),然后在它的配置标签页中声明它所产生的内容:

产生的请求头
Authorization{{token_type}} {{access_token}}

该值是一个针对身份验证请求的响应正文求值的表达式。顺便填好过期时间表达式 (例如 {{expires_in}}),Restorm 就会自动续期令牌。

回到您的 GET 请求,在顶部栏中选择这条认证路由。此后每次发送都会注入该请求头, 而且遇到 401 会自动触发一次续期并重试。

详情:身份验证

  • 已经有规范文件或集合了?文件 ▸ 导入Ctrl+I)会重建整棵树:参阅 导入与导出
  • 用一个场景串联多个调用并校验结果。
  • 让这个场景在您的 CI 中运行: headless 执行