使用 Thunder Client 调用 Salesforce API 的完整指南

UrbanJazzerati2025-07-08 13:58

一、工具概述与优势

Thunder Client 是 VS Code 的轻量级 API 测试插件，凭借其集成开发环境（IDE）的无缝协作能力，在开发者社区中迅速崛起。相较于 Postman，Thunder Client 在以下方面具有显著优势：

免费版无敏感信息存储限制
原生支持 OAuth 2.0 隐式授权流程 (Postman 免费版不支持）
环境变量（Env）实时同步功能 （Postman 免费版不支持环境变量）

二、准备工作

安装 VS Code 并通过扩展商店安装 Thunder Client

在 Salesforce 开发者账号中创建连接应用（Connected App），获取：
- Client ID
- Redirect URL
在 Thunder Client 中创建新环境（File > Preferences > Thunder Client > Environments）

三、OAuth 2.0 隐式授权流程

3.1 构建授权请求

新建 POST 请求
设置 URL 为 Salesforce 授权端点：

bash 复制代码

https://<your-instance>/services/oauth2/authorize

Query Parameters 配置：

ini 复制代码

*   response_type=token
*   client_id=<Your_Client_ID>>
*   redirect_uri=<Your_Redirect_URL>>
*   display=popup
*   scope=api id

3.2 处理回调与 Token 提取

发送请求后，在标签页点击 "Get Access Token From Callback URL"

系统自动解析回调 URL 中的 token 参数

代码片段说明 ：Thunder Client 内部通过 window.location.replace() 模拟浏览器重定向行为，开发者无需手动处理回调逻辑。

四、API 调用实践

4.1 查询用户信息

新建 GET 请求
URL 设置为：

bash 复制代码

{{INSTANCE_URL}}/services/oauth2/userinfo

Headers 配置：

css 复制代码

*   Authorization: Bearer {{ACCESS_TOKEN}}
*   Content-Type: application/json

4.2 响应处理

成功响应示例（Status 200 OK，Size 3.63 KB）：

json 复制代码

{
  "totalSize": 1,
  "done": true,
  "records": [
    {
      "attributes": {
        "type": "Lead",
        "url": "/services/data/v60.0/sobjects/Lead/00QC6123456sDbNMAU"
      },
      "Id": "00QC6123456sDbNMAU"
    }
  ]
}

五、高级技巧

5.1 使用 Collections 管理 API 流程

创建新集合（Collection）