API Tester

你可以

• 点击新建请求。卡片列出六种协议（REST · WS · GQL · SSE · IO · MQTT），并打开请求屏幕。
• 点击集合或历史记录。每张卡片显示你有多少条，没有时显示空。
• 使用顶部的实时标签条，它只在有内容运行时才出现：每个打开的请求、带端口的 Mock Server、已连接的 WebSocket、SSE、Socket.IO 和 MQTT 会话、一次负载测试或一次集合运行。点击其中一个，就会回到它。

你不能做什么，以及原因

• 在起始页选择协议、输入 URL、选择环境或打开工具：这些都不在那里。有意为之
• 通过回到起始页来关闭实时连接：它们会继续运行，这正是设有这些标签的原因。有意为之

你可以

• 在八种方法中选择：GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS 和 TRACE，每种有自己的颜色。REST 和 GraphQL 会显示方法选择器。
• 点击发送（纸飞机）。请求运行期间它会变成取消请求。
• 选择协议：REST、WebSocket、GraphQL、SSE、Socket.IO 或 MQTT。
• 选择当前环境，或选择无环境；管理环境会打开编辑器。
• 打开 ⋮ 菜单：新建、复制（在名称后加上“ (copy)”）、保存、导出 cURL、生成代码和负载测试。在手机上它还会列出首页、集合和历史记录。

你不能做什么，以及原因

• 选择 GraphQL 请求的方法：选择器就在那里，但该面板始终发送 POST。尚未提供
• 给请求命名：没有对应的字段，所以你保存的请求都叫 New Request（导入的请求保留自己的名称）。尚未提供

你可以

• 用添加参数或添加 header添加行，用各自的复选框启用或停用，拖动可重新排序，滑动可删除。
• 打开某一行的详情，可以添加说明，或打开密钥值：该值在界面中会被遮蔽，并且不会出现在导出的 cURL 和生成的代码中。
• 用批量编辑粘贴 Key: value 形式的多行内容。

你不能做什么，以及原因

• 从列表中选择常用 header：没有 header 自动补全。尚未提供
• 让查询参数自动做百分号编码：它们按你输入的内容加到 URL 上，编码 URL开关没有任何作用。尚未提供

你可以

• 选择类型。None、JSON、Form URL-Encoded、Multipart Form 和 Raw Text 是标签；XML、HTML、JavaScript、Binary 和 GraphQL 在更多…下面。共十种，在所有语言中都用英文命名。
• 在 JSON 中：行号、实时校验（JSON 无效：…）以及美化 / 压缩。
• 在 Form URL-Encoded 和 Multipart Form 中：键值行。Multipart 的行可以是文本字段或文件字段（选择文件，通过系统文件选择器）。
• 在 Binary 中：选择二进制文件。在作为正文类型的 GraphQL 中：一个查询和变量 (JSON)。
• 在原始文本、JSON、XML、HTML、JavaScript 正文和表单字段中使用 {{variables}}：发送时它们会被替换。

你不能做什么，以及原因

• 在正文编辑器中获得语法高亮。有意为之
• 为 GraphQL 正文设置操作名称，或在它的查询和变量中使用 {{variables}}。尚未提供

你可以

• 选择授权类型：Authorization Code、Client Credentials、Password Credentials 或 Implicit。
• 使用 Client Credentials 时，填写 Token URL、Client ID、Client Secret 和 Scope，然后点击获取令牌。
• 使用 Authorization Code 时，点击打开浏览器，登录后，从你被送回的地址中复制 code 的值，粘贴到授权码下，再点击兑换授权码。
• 使用 Password Credentials 或 Implicit 时，自己把令牌粘贴到访问令牌中：没有对应的按钮。
• 在凭据中使用 {{variables}}。想让令牌不显示出来，就把它存为密钥环境变量，并在这里写 {{token}}。

你不能做什么，以及原因

• 让应用替你捕获 OAuth 重定向：模块无法注册回到应用的链接，所以由你粘贴授权码。有意为之
• 使用 PKCE 或刷新令牌。尚未提供
• 把 OAuth 2.0 令牌发送到 Authorization: Bearer … header 以外的任何位置。尚未提供
• 使用 Hawk 或 NTLM：选择它们后，发送时什么也不会发生。尚未提供
• 遮蔽你在认证中输入的内容：令牌和密码在此屏幕上以明文显示。尚未提供

你可以

• 用添加断言添加一条断言：一个字段（Status code、Response time、Header、Body (JSONPath) 或 Body size）、一个运算符（equals、does not equal、contains、does not contain、is greater than、is less than、exists、does not exist）和一个期望值。断言始终会运行，不需要 JavaScript 引擎。
• 插入九个快速模板之一：Status is 200、Status is 2xx、Response time < 500ms、Has JSON body、Body not empty、Has Content-Type、JSON schema valid、Body contains string、Array length > 0。
• 为请求前脚本和测试脚本编写 JavaScript。它们在隔离的引擎（androidx.javascriptengine）中运行，每次都是全新的引擎，所以崩溃的脚本不会让应用崩溃。
• 使用 pm 子集：pm.test(name, fn)；pm.expect(value) 及 equal、include、above、below、within、an(type)、empty 和它们的 not 形式；pm.environment.get 与 pm.environment.set；pm.globals.get（只读）；pm.request（method、url、headers、body：只读副本）；在测试中还有 pm.response（code、status、headers、responseTime、text()、json() 以及 to.have.status / header / jsonBody）；以及 console.log / info / warn / error。
• 放心依赖 pm.environment.set 会被保存：它先更新已有的全局变量，再更新当前环境中的变量，否则在当前环境中新建一个（没有当前环境时则新建全局变量）。
• 在响应的测试标签页中查看结果，在控制台中查看脚本的输出。

你不能做什么，以及原因

• 使用 Postman API 的其余部分：pm.sendRequest、pm.variables、pm.collectionVariables、setNextRequest、require 和 pm.globals.set 都不存在，脚本不能修改请求，也没有异步。需要它们的 Postman 脚本会在控制台中以 Script error: … 结束。有意为之
• 在没有较新 WebView 的设备上运行脚本：脚本会被跳过，控制台中出现一条警告，只有断言会运行。设备
• 让集合或文件夹的脚本运行：它们会被导入并保存，但只有请求自己的脚本会执行。尚未提供
• 按 JSON schema 校验正文：JSON schema valid 模板只检查正文是不是 JSON。尚未提供

你可以

• 直接设置超时 (ms)（任意数字，默认 30000），或在面板中选择 5、10、15、30、60 或 120 秒。一个值同时管连接、读取和写入。
• 切换跟随重定向和验证 SSL。
• 切换启用 Cookie和编码 URL：只能在面板中操作。

你不能做什么，以及原因

• 设置代理、客户端证书或最大重定向次数：没有任何屏幕提供它们。尚未提供
• 让编码 URL起作用：开关在那里，但发送时会忽略它。尚未提供

你可以

• 打开新建标签页，切换标签页，用 ✕ 关闭它们。圆点表示请求在保存后有改动；空请求显示为无标题。
• 点击 ⋮ → 保存，会看到保存到集合：选择一个集合（会显示它的请求数量），或输入新名称并点击创建。
• 使用 ⋮ 菜单中的复制和新建，并用导出 cURL打开生成的 cURL，再点击复制。

你不能做什么，以及原因

• 在手机或竖屏平板上用标签页打开请求：标签页只存在于横屏平板布局，快捷键也是一样。也没有 Ctrl+F 或 Ctrl+K。有意为之
• 切换标签页时保留响应：它会被清除。尚未提供

你可以

• 查看按范围着色的状态标签（2xx 绿色、3xx 青绿色、4xx 橙色、5xx 红色），以及总耗时、大小和内容类型。
• 在六个标签页之间切换，顺序为：正文、Headers（带数量；可复制任一 header）、Cookies（name=value、域名和路径，带 Secure 和 HttpOnly 标记）、测试（断言和脚本结果；为空时显示此响应没有运行测试）、时间线和控制台。
• 查看时间线：DNS、TCP、TLS、TTFB 和 Transfer，外加 Total。
• 查看控制台：整个会话的日志（发送、脚本、Mock Server、连接），带时间和级别：LOG、INFO、WARN 或 ERROR。

你不能做什么，以及原因

• 查看协议、远程 IP 或重定向链：面板不显示它们。尚未提供
• 查看请求失败的原因：遇到网络、TLS 或超时错误时，面板只显示一个 0 Error 标签和空正文。原因会写入控制台日志。尚未提供
• 清空控制台：它没有清除按钮。尚未提供

你可以

• 用右下角的悬浮按钮切换视图：Pretty、Raw 或 Preview。复制按钮紧挨着它。
• 在 Pretty 下，浏览可折叠的 JSON 树，它有两个筛选器：搜索键…和 JSONPath 筛选 · $.a.b[0].c（精确路径；什么也没找到时显示未找到匹配该路径的结果）。
• 打开某个节点的 ⋮ 菜单：复制值、复制路径和保存为变量（选择一个环境和一个名称）。
• 在 Raw 下，查看等宽文本；超过 512 K 字符的正文会使用虚拟化列表。
• 在 Preview 下，text/html 会在关闭 JavaScript 的 WebView 中渲染；其他任何类型都会显示此内容类型没有可用的预览。

你不能做什么，以及原因

• 让 XML 或 HTML 自动格式化：只有 JSON 会被格式化，其他内容原样显示。尚未提供
• 预览图片：预览从未收到图片字节。尚未提供
• 在正文中搜索并高亮匹配项、跳到顶部或底部，或者分享、保存响应到文件。尚未提供

你可以

• 输入端点并点击获取 Schema（标准的内省 POST）。Schema 会显示找到了多少个类型；每个类型展开后是它的字段、字段类型和参数数量，例如 2 个参数。以 __ 开头的类型会被隐藏。
• 编写查询，以及在可折叠区域中编写变量 (JSON)；发送；在常规响应面板中查看结果。查询和变更都以 HTTP POST 发送。

你不能做什么，以及原因

• 在此面板中设置操作名称、header 或认证：它只发送 Content-Type: application/json。需要认证时，请使用带 GraphQL 正文的 REST 请求。尚未提供
• 使用订阅：探索器会列出 Subscription 类型，但所有内容都通过 HTTP POST 发送，没有 graphql-ws 传输。尚未提供
• 查看参数名称：只能看到数量。尚未提供

你可以

• 查看状态：CONNECTING、CONNECTED、DISCONNECTING、DISCONNECTED 或 ERROR。
• 输入消息，连接后发送。
• 查看聊天式的日志（发出的在右，收到的在左，带时间），并用清除消息清空。

你不能做什么，以及原因

• 添加 header 或子协议、自动重连或保存消息模板。尚未提供
• 发送或读取二进制消息：只支持文本。尚未提供
• 在 URL 中使用 {{variables}}。尚未提供

你可以

• 查看状态（CONNECTING、CONNECTED、DISCONNECTED 或 ERROR）和计数，例如 12 个事件。
• 查看事件日志：类型标记、id: … 和 data 的前 300 个字符。

你不能做什么，以及原因

• 发送 header、按事件类型筛选、自动重连或遵循服务器的 retry: 值。尚未提供
• 查看每个事件的时间或 retry，或从 Last-Event-ID 恢复：id 会被保留，但既不显示也不发送。尚未提供
• 使用 {{variables}}、cookie 存储或验证 SSL：这里都不适用。尚未提供

你可以

• 输入 URL（例如 http://localhost:3000）和命名空间（默认 /，不会追加任何内容；其他名称会追加到 URL 后面）。
• 切换自动重连（默认开启）。
• 用添加监听监听某个事件名，用发送配合 JSON 负载发出事件：它会作为真正的 JSON 值（对象、数组或标量）发送，无法解析时则作为文本发送。
• 查看聊天式的日志，每个气泡都带有事件名，并可清空。

你不能做什么，以及原因

• 设置 header、auth、查询参数或传输方式，移除监听，或在一个连接中使用多个命名空间。尚未提供
• 知道它能和哪些版本的 Socket.IO 服务器通信：客户端是官方的 socket.io-client 2.1.2，由这个库决定。第三方

你可以

• 切换使用 TLS（使用系统证书），并设置客户端 ID（生成为 pocketcode- 加八个字符）、用户名和密码（只有用户名不为空时才会发送；该字段被遮蔽，带显示/隐藏的眼睛图标）。
• 以 QoS 0（At most once）、1（At least once）或 2（Exactly once）订阅某个主题；订阅列表会显示它们。
• 发布到发布主题，带文本负载和 QoS。
• 查看收发的消息，按主题分组。

你不能做什么，以及原因

• 选择 MQTT 版本：客户端只支持 MQTT 5，所以只支持 3.1.1 的 broker 可能会拒绝连接。尚未提供
• 以 retain 标志发布。尚未提供
• 取消订阅、设置遗嘱、keep-alive 或 clean-session、MQTT 5 属性、使用自己的 TLS 证书，或通过 WebSocket 连接。尚未提供

你可以

• 按名称搜索集合。
• 用新建集合（圆形按钮）创建一个。在 Free 上已有一个集合时，它会改为打开 API Tester Pro 窗口。
• 展开集合以列出其中的请求（带颜色的方法，然后是名称或 URL），点击一个即可载入：你会回到请求屏幕。
• 打开集合的 ⋮ 菜单：运行（带 Pro 标记）、导出、保存到项目和删除。删除不会要求确认。
• 用保存到集合把当前请求存入一个集合。
• 在保存到集合中输入新名称，即可当场创建一个集合。在 Free 上同样受一个集合的上限约束：已有一个时，对话框会关闭并打开 API Tester Pro 窗口。

你不能做什么，以及原因

• 重命名、移动或重新排序集合或请求，或创建文件夹：没有对应的屏幕。尚未提供
• 打开文件夹：文件夹（随导入和项目文件一起出现）显示为一行不响应的名称 (n)。你无法在这里展开它们或打开其中的请求，不过执行器会遍历它们。尚未提供
• 让集合或文件夹的认证、header 或脚本生效：它们会被导入、保存和导出，但发送和运行只使用请求自身的内容。尚未提供
• 编辑集合的变量：它们只通过导入和项目文件进来，并且只在请求是从该集合载入时才会使用。尚未提供
• 在 Free 上保留多个集合：新建集合、在保存到集合中输入新名称以及导入，都会打开 API Tester Pro 窗口。Pro

你可以

• 从工具 → 环境，或环境菜单 → 管理环境打开它。该面板会阻止截屏。
• 用标签选择当前环境（无或你自己的某一个）；下方的卡片用于编辑。
• 点击新建环境（对话框会询问名称），删除环境（不会要求确认），并查看哪一个是已激活。
• 在 KEY 和值两列中编辑变量，并用添加变量添加更多。
• 把变量锁定为密钥：它的值会用圆点遮蔽，点击眼睛图标可显示，离开后又会重新遮蔽。
• 打开全局变量（可折叠）并使用添加全局变量：无论哪个环境处于激活状态，它们都可见。
• 从响应创建变量：在 JSON 树中，某个节点的 ⋮ → 保存为变量。

你不能做什么，以及原因

• 为每个变量选择作用域、编辑初始值或选择环境颜色：编辑器里只有环境变量和全局变量。尚未提供
• 导入或导出单个环境：Postman 环境无法导入，Insomnia 的导入会把文件中所有环境的变量压平成一个集合变量列表。尚未提供
• 在 Free 上拥有第二个环境：创建它会打开 API Tester Pro 窗口。Pro

你可以

• 按 URL 或名称搜索历史记录，并用已加星标和按方法筛选（只提供 GET、POST、PUT 和 DELETE）。
• 查看按今天、昨天、本周（最近七天）和更早分组的记录，每条带有方法、状态码、耗时和时间。
• 点击一条记录以载入请求及其保存的响应；用星标标记它。
• 打开记录的 ⋮ 菜单：与…比较和用作模拟（如果记录没有响应，两者都是灰色）。
• 点击清除所有历史记录。它不会要求确认。

你不能做什么，以及原因

• 保留超过 200 条记录：超出后最旧的会被删除，Free 和 Pro 都一样。有意为之
• 在 Free 上保存超过 10 条历史记录：新请求不会被保存，直到你清除历史。Pro
• 按日期范围或状态码筛选，或删除单条记录。尚未提供

你可以

• 从集合 → ⋮ → 运行打开它。标题显示执行器，返回手势会回到集合。
• 选择集合（选择要运行的集合），并用 − 和 + 设置迭代次数（1 到 100）。
• 选择数据文件（选择文件；CSV 或 JSON）。它的行数会取代迭代次数，并停用步进器；移除数据文件可撤销。CSV 需要一行表头（逗号和双引号，不支持多行字段）；JSON 必须是由扁平对象组成的数组。每一行为 {{column}} 变量提供值，优先于集合、环境和全局变量。
• 点击运行集合，或取消运行。状态显示为空闲、运行中、已完成、失败或已取消；数字显示请求数、测试（通过 / 总数）和耗时；每次迭代都会列出它的请求，带方法、状态码、耗时和通过 / 总数。

你不能做什么，以及原因

• 在 Free 上运行它：运行会打开执行器，但 API Tester Pro 窗口会出现在它上方，运行集合不会运行任何内容。Pro
• 在请求之间加延迟、遇到第一个错误就停止、保存响应或在多次运行之间保留变量。尚未提供
• 保留或导出结果：它们不会被保存。尚未提供
• 依赖失败状态来反映网络错误：它表示有断言失败，所以一个出错且没有断言的请求不会让运行显示为失败。尚未提供

你可以

• 从 ⋮ → 负载测试打开它。目标是当前载入请求的方法和 URL；没有打开请求时显示未选择请求。
• 设置请求数（最多五位数）、并发数（四位）和爬坡时间（秒）（三位），然后点击开始，或取消。
• 用并发数（默认 10）设定同时发送请求的工作线程数。它们分摊请求数，每个线程在上一个请求得到应答后立即发送下一个。同时最多 100 个，也不会超过请求数；留空或填 0 表示一次一个。
• 用爬坡时间（秒）让工作线程在这么多秒内错开启动：n 个线程中的第 k 个（k 从 0 开始）在爬坡时间 × k / n 秒后启动。填 0 则全部同时启动。
• 查看进度（n / N 个请求）；p50、p90、p95 和 p99；平均、最小和最大；请求/秒；成功和失败；状态码分布；以及最多 20 条错误消息。

你不能做什么，以及原因

• 同时发送超过 100 个请求：并发数上限是 100，也不会超过请求数。有意为之
• 设置总时长或思考时间：没有对应的字段。尚未提供
• 测试流式协议：只能测试当前载入的 REST 请求。尚未提供
• 在 Free 上启动它：屏幕会打开，但开始会打开 API Tester Pro 窗口，不会发送任何请求。该入口没有标记。Pro

你可以

• 打开工具 → Mock Server。在标题处把它打开：副标题显示 http://127.0.0.1:<port>，或显示已停止。
• 设置端口（默认 8090；0 表示让系统选择；运行时锁定）和延迟 (ms)（0 到 60,000），它会加到每个应答上。
• 查看提示仅监听回环地址：本设备可访问，网络中不可访问。
• 点击添加路由。新建 Mock 路由会询问方法（GET、POST、PUT 或 DELETE）、路径、状态码和响应正文。每条路由都有开关和删除按钮。
• 查看已处理请求的日志（面板显示最近 30 条，最多保留 200 条）：时间、状态码、METHOD path，以及匹配到的路由，或未匹配到路由。全部清除会清空它。
• 也可以从其他地方获得路由：导入 OpenAPI（从此 OpenAPI 生成模拟）和历史记录中的用作模拟。

你不能做什么，以及原因

• 创建后编辑路由，或在对话框中设置它的 header、延迟或优先级：你只能开关它或删除它。导入会用默认值填充这些字段。尚未提供
• 在关闭模块后保留路由和日志：它们保存在内存中，服务器会随屏幕一起停止。尚未提供
• 从其他设备或通过 HTTPS 访问它：它只监听回环地址，没有 TLS，所以你的测试数据不会暴露在咖啡馆的 Wi-Fi 上。有意为之
• 在 Free 上打开它：开关保持关闭，并打开 API Tester Pro 窗口。Pro

你可以

• 打开工具 → Cookies。Cookie 存储的副标题会给出数量（例如 已存 3 个）；每个 cookie 显示名称、值、Secure 时的锁图标、HttpOnly、域名和路径。
• 用 ✕ 移除一个，或点击全部清除。
• 在单个响应的 Cookies 标签页中查看该响应的 cookie。

你不能做什么，以及原因

• 手动添加或编辑 cookie。尚未提供
• 彻底删除已保存的 cookie：✕ 和全部清除只会清空显示的列表，设备上保存的副本不会被擦除，所以它们可能重新出现。尚未提供
• 区分 host-only cookie 和域名 cookie：存储把它们同等对待。尚未提供

你可以

• 在 27 个目标中选择，它们产生 26 种不同的输出（cURL 和 Shell — cURL 是同一条命令）：cURL、HTTPie、Wget；JavaScript（Fetch、Axios、XHR、jQuery）；TypeScript（Fetch）；Python（Requests、http.client）；Java（OkHttp、HttpURLConnection、HttpClient 11+）；Kotlin（OkHttp、Ktor）；Swift（URLSession）；Go（net/http）；PHP（cURL、Guzzle）；Ruby（Net::HTTP）；C#（HttpClient、RestSharp）；Rust（reqwest）；Dart（http）；R（httr）；PowerShell；Shell（cURL）。
• 得到方法、带已启用查询参数的 URL、已启用的 header 和正文（原始、JSON、XML、HTML、JavaScript、form-urlencoded，或以 {"query":…,"variables":…} 形式表示的 GraphQL）。{{variables}} 会用当前环境解析，密钥除外，它们保留为 {{name}}；密钥行显示 ••••••••。

你不能做什么，以及原因

• 在生成的代码中得到认证，cURL 除外：其他所有目标都会省略它。cURL 会加入 Bearer、Basic、Digest、Custom 和基于 header 的 API Key，但不包括 OAuth 2.0 或 AWS Signature。尚未提供
• 得到 Multipart 或 Binary 请求的正文：输出为空。尚未提供

你可以

• 在导入请求中选择一个格式：cURL、Postman (v2.1)、Insomnia、OpenAPI / Swagger、HAR File 或 OpenAPI YAML。粘贴文本并点击导入；没有文件选择器。
• cURL 会替换当前请求，其余五种会创建一整个集合，并提示 已导入“name” — N 个请求 或 导入失败：…。
• 使用 OpenAPI 格式时，勾选从此 OpenAPI 生成模拟，为每个方法和路径添加一条 mock 路由。
• 点击从项目导入读取以文件形式保存的集合（见保存到项目）。

你不能做什么，以及原因

• 导入 Postman 环境（只能导入集合），或从文件导入：你只能粘贴文本。尚未提供
• 在 Free 上导入第二个集合：面板会关闭，并打开 API Tester Pro 窗口。Pro
• 查看 cURL 导入失败的原因：错误只会写入控制台。尚未提供

你可以

• 在导出“name”中，选择 Postman Collection v2.1、Insomnia Export、OpenAPI 3.0、HAR Archive 或 Markdown Documentation，查看预览并复制（已复制到剪贴板）。Markdown 会加入来自你历史记录的响应示例，按方法和 URL 匹配，以最新的为准。

你不能做什么，以及原因

• 把导出保存为文件或分享：你只能复制它。尚未提供

你可以

• 在拉取请求中审查这些文件并提交：认证值、密钥行以及名称像密钥的 header、参数和表单字段都以空值保存，所以文件展示的是集合的结构，而不是你的凭据。

你不能做什么，以及原因

• 把密钥挡在文件里的原始正文或脚本之外：两者都按输入内容原样写出，所以粘贴在那里的令牌会随文件一起提交。有意为之

你可以

• 从导入面板打开从项目导入（没有打开的项目时，它会说明打开一个项目才能从文件导入集合）。
• 选择 .pocketcode/api/ 下的一个文件夹并查看预览，预览不会改动你的数据：新集合“name” — N 个请求，或这将用文件中的 M 个请求替换“name”（当前 N 个请求）（当 _collection.json 中的 id 与现有集合匹配时为替换），外加 N 个文件因错误被跳过。
• 用导入或替换（红色）确认，或点击取消：什么都不会自动应用。
• 使用替换时，你已有的密钥会保留：文件中为空的值不会覆盖本地同 id 集合里的值（认证类型相同、行相同）。新集合则从这些空值开始。

你不能做什么，以及原因

• 在 Free 上已经有集合时，从文件导入新集合：会打开 API Tester Pro 窗口。替换已有集合则始终允许。Pro