Docs/API Tester

API Tester

FreePro 用于模拟服务器、集合运行器和性能测试

集成在 IDE 中的专业 HTTP 客户端。Postman / Insomnia 的功能等价物:支持 REST、WebSocket、GraphQL 和 Server-Sent Events;管理层次化集合、历史记录、带 {{var}} 变量的环境、持久 cookie jar、本地模拟服务器和 25+ 种语言的代码生成。

三个主要目标

Request

当前请求的活动编辑器:URL 栏、参数、标头、正文、身份验证、脚本、设置。

Collections

层次化集合(集合 → 文件夹 → 请求),带搜索、重命名和重组。

History

带方法和星标过滤器的历史记录,按日期分组(今天 / 昨天 / 本周 / 更早)。

支持的协议

REST

8 方法

GET · POST · PUT · PATCH · DELETE · HEAD · OPTIONS · TRACE。彩色编码的方法。健壮的 HTTP 客户端,带可配置的超时、托管的 cookie jar、跟随重定向和可选的 SSL 验证。

WebSocket

WS

wss:// 连接、自定义标头、子协议。状态(CONNECTING / CONNECTED / DISCONNECTED / ERROR)。聊天式历史记录(已发送 / 已接收)。自动重连和已保存的消息模板。

GraphQL

GQL

查询编辑器、JSON 变量、操作名称。带 introspection 的 Fetch Schema。Schema 浏览器(类型、字段、参数)。支持 queries、mutations 和 subscriptions。

SSE

Server-Sent Events

URL + 自定义标头。实时事件时间线(id、事件类型、数据、时间戳、重试)。按类型过滤。尊重服务器重试的自动重连。Last-Event-ID 跟踪。

请求编辑器部分

粘性 URL 栏 + 带六个可折叠部分的手风琴。每个部分都有其强调色(Params 青色、Headers 洋红色、Body 橙色、Auth 绿色、Scripts 黄色、Settings 蓝色)。

URL bar

方法 chip(8 个方法)、等宽字体 URL 输入、带 spinner 的发送按钮、协议选择器(REST / WS / GQL / SSE)。

Params

带每行启用/禁用复选框的查询参数,活动参数计数器。

Headers

常见标头自动补全(Content-Type、Accept、Authorization、Cache-Control、User-Agent…)。

Body

10 种类型:None、JSON(带美化/压缩)、Form URL-Encoded、Multipart (TEXT/FILE)、Raw、XML、HTML、JavaScript、Binary、GraphQL。

Auth

10 种类型,带渐进式披露(见下表)。

Scripts

Postman 风格 JavaScript 中的预请求和测试脚本。带 LOG/INFO/WARN/ERROR 级别的控制台输出。

Settings

超时、跟随重定向、验证 SSL、启用 cookies、编码 URL、代理、客户端证书。

身份验证类型

常见

None

—

Bearer

Token + prefix

Basic

用户名 + 密码

API Key

名称 + 值 + 位置(Header / Query)

高级

OAuth2

Authorization Code · Client Credentials · Password · Implicit

Digest

realm · nonce · algorithm · qop · opaque

AWS Signature v4

accessKey · secretKey · region · service · sessionToken

Hawk

authId · authKey · algorithm · ext

NTLM

username · password · domain · workstation

Custom

自由名称 + 值

Response panel

Empty / Loading / Success / Error 状态。带按范围彩色编码的状态 chip(2xx 绿、3xx 蓝、4xx 橙、5xx 红)、时间、大小、协议和远程 IP 的标头。

Body

Headers

Timeline

Tests

Info

•带 Pretty(格式化 JSON/XML/HTML)、Raw、Preview(渲染的 HTML)和 Tree(可折叠 JSON)视图的正文
•带 DNS · TCP · TLS · TTFB · 内容传输的时间线
•Tests 显示脚本的断言结果
•在正文中搜索,带匹配项突出显示和跳转到顶部/底部
•复制、分享、保存响应、带每个 URL 和状态的重定向链

环境和变量

在 URL、标头、正文、身份验证和 cookies 中用 {{var}} 语法插入的变量。每个变量都有一个范围(Global / Environment / Collection / Local),可以标记为 secret 以隐藏值。

多环境

创建 / 删除 / 激活环境。一次仅一个活动。

Globals

从任何环境可见的全局变量。

Secrets

标记为 secret 的变量在 UI 中隐藏其值。

范围解析

Local > Collection > Environment > Global

Free:1 个环境。Pro:无限。

Mock Server

Pro

设备上的本地 HTTP 服务器(默认端口 8090),带模拟路由的 CRUD。每个路由定义方法、带模式的路径 (/users/:id)、状态代码、标头、正文、模拟延迟和匹配优先级。

•从表单切换服务器开/关
•传入请求的日志(方法、路径、匹配的路由、状态、时间戳)
•每个路由可配置的延迟
•任意响应标头和正文

代码生成器 — 25+ 种语言

将当前请求转换为即用即贴的代码。每个输出都包含导入、标头/正文/身份验证设置和基本错误处理。

cURL

HTTPie

Wget

JS — Fetch

JS — Axios

JS — XHR

JS — jQuery

TS — Fetch

Python — requests

Python — http.client

Java — OkHttp

Java — HttpURLConnection

Java — HttpClient 11+

Kotlin — OkHttp

Kotlin — Ktor

Swift — URLSession

Go — net/http

PHP — cURL

PHP — Guzzle

Ruby — Net::HTTP

C# — HttpClient

C# — RestSharp

Rust — reqwest

Dart — http

R — httr

PowerShell

Import / Export

Import

• cURL
• Postman v2.1
• Insomnia
• OpenAPI 3.0 / Swagger
• HAR

Export

• cURL
• Postman v2.1
• Insomnia
• OpenAPI 3.0
• HAR
• Markdown

cURL 转换器是双向的:解析 -X、-H、-d、--data-urlencode、-F、--data-binary、-u、--digest、--ntlm、--proxy、--connect-timeout、-k、-L、--max-redirs 标志。

底部表单

Environments

带插值的环境和变量

带 Secure/HttpOnly 徽章的持久 cookie jar

Import

导入 cURL、Postman、Insomnia、OpenAPI、HAR

Code Generator

生成 25+ 种语言的代码

Mock Server

带模拟路由的本地 HTTP 服务器(Pro)

Settings

超时、重定向、SSL、cookies、代理、证书

Tools

快速操作网格:新建、复制、保存、导入/导出、工具

Free vs Pro 计划

功能	Free	Pro
REST / WS / GraphQL / SSE 协议	✓	✓
完整编辑器(参数、标头、正文、身份验证、脚本)	✓	✓
完整响应面板(标签、时间线、测试)	✓	✓
Cookie jar	✓	✓
导入 (cURL、Postman、Insomnia、OpenAPI、HAR)	✓	✓
代码生成器(25+ 种语言)	✓	✓
Collections	1	无限
环境和变量	1	无限
请求历史	有限	无限
Mock Server	—	✓
集合运行器(批量执行)	—	✓
性能 / 负载测试	—	✓

模块统计

协议

HTTP 方法

正文类型

身份验证类型

Bottom sheets

25+

代码生成语言

响应标签页

下一步

数据库