课程章节介绍
同学们，我们来看下一个环节：怎么把 ADL API 的环境给搭起来。这块儿听起来步骤不少，别担心，我带着大家一步一步走一遍，你就清楚了。
首先呢，我们要准备几件工具。第一个是 Salesforce CLI，咱们在命令行里跟 Salesforce 交互的基本工具，这个你应该已经装好了。第二个是 jq，它是一个命令行下处理 JSON 的小能手，后面解析接口返回的数据时会用到，因为它输出特别整洁。然后你还需要一个测试用的 PDF 文件，这是我们后续要拿来做文档处理的素材。最后还得有个配置好的测试组织，也就是一个可以随便折腾的 Developer Edition 或者沙盒环境。
好，有了这些，咱们进到 Salesforce 设置里，创建一个外部客户端应用程序。这是什么意思呢？就是我们要让外部系统（比如你本地的脚本）能够代表自己调用 Salesforce 的 API，这需要用到客户端凭据流。在设置的应用管理器里，新建一个连接应用，勾选上“客户端凭据流”，并给它配置标准的 OAuth 范围。注意这里的范围要包含 `chatter_api`，因为我们最终要访问 Connect REST API，它跟 Chatter 能力是绑定的，所以这个权限必须勾上。同时建议把 `api`、`refresh_token` 这些常用的也加上。配置好以后，启用它，让它支持 JWT 令牌，这样我们就拿到了一对消费者密钥和消费者 secret。
接下来，我们就要用 curl 实战了。打开终端，先用刚才拿到的消费者密钥和 secret 去换一个访问令牌。命令大概长这样：用你的消费者 key:secret 作为基本认证，向 Salesforce 的 OAuth 令牌端点发一个 POST 请求，指明 grant_type 是 client_credentials。这个请求返回的 JSON 里就会包含 access_token。我们可以用 jq 把它提取出来存成环境变量，方便后面用。
拿到令牌之后，先别急着干别的，先验证一下连通性。你可以调用一个简单的数据库端点，比如查询一下组织信息，或者用 Connect API 访问一下 `/services/data/v63.0/connect/communities` 试试，看到 200 的返回就说明一切就绪。
最后，在终端里设两个 shell 变量，一个叫 LIBRARY_NAME，你自己起一个唯一的库名称，比如 `my_doc_lib_001`；另一个叫 TEST_PDF_PATH，指向你准备好的那个测试 PDF 文件的路径。这样后面我们跑脚本的时候直接引用这些变量就行，不用反复改命令。
你看，其实就是准备工具、建连接应用、拿令牌、验证、设置变量这五步。整个流程走下来，我们的环境就准备好了，下一节就可以开始真正调用 ADL API 去创建文档库、上传内容了。有什么问题随时叫停我哦。