Module 7: REST APIs

1

第 257 页

今天我们来聊聊Salesforce中的REST APIs。REST API是一种非常流行的网络服务接口，它允许不同的应用程序通过互联网进行通信。在Salesforce中，REST API可以帮助我们与Salesforce的数据进行交互，比如创建、读取、更新或删除记录。首先，REST代表的是“Representational State Transfer”，这是一种设计风格，用于创建网络服务。它使用标准的HTTP方法，比如GET、POST、PUT和DELETE，来执行操作。这些方法对应着我们常说的“增删改查”。在Salesforce中使用REST API，首先需要设置一个连接。这通常涉及到创建一个“Connected App”来获取访问令牌（OAuth Token）。这个令牌是安全访问Salesforce数据的钥匙。一旦你有了访问令牌，你就可以开始使用REST API了。例如，如果你想获取某个Salesforce对象的所有记录，你可以发送一个GET请求到该对象的REST API端点。Salesforce会返回一个JSON格式的响应，里面包含了所有请求的数据。如果你想创建一个新的记录，你可以发送一个POST请求，并在请求体中包含新记录的详细信息。Salesforce会处理这个请求，并返回新创建的记录的ID。更新和删除记录也很简单。使用PUT请求来更新记录，使用DELETE请求来删除记录。每种操作都需要发送到正确的API端点，并包含必要的数据。总的来说，REST API是一个非常强大的工具，它使得Salesforce的数据可以被外部应用程序轻松访问和操作。通过掌握REST API，你可以扩展Salesforce的功能，使其与你的其他业务系统无缝集成。希望这个简单的介绍能帮助你理解Salesforce中的REST API。如果你有任何问题，随时提问！

查看详情

2

Module Objectives - 258

第 258 页

让我们来聊聊这个模块的目标。在这个模块结束的时候，你会学到两件重要的事情。首先，你会了解到REST API的功能以及它使用的技术。REST API是一种让不同的软件系统能够互相交流的方式。它使用了一些标准的技术，比如HTTP协议，这样不同的系统就可以通过网络发送和接收数据了。其次，你会明白开发人员是如何与REST API进行交互的。开发人员会使用一些工具和编程语言来发送请求到REST API，并接收返回的数据。这样，他们就可以在自己的应用程序中使用这些数据了。所以，简单来说，这个模块会让你明白REST API是什么，它是如何工作的，以及开发人员是如何使用它的。这样，你就能更好地理解现代软件系统是如何互相通信的了。

查看详情

3

Module Agenda - 259

第 259 页

今天我们来聊聊Salesforce的REST API。REST API是一种基于HTTP协议的接口，它允许你通过发送HTTP请求来与Salesforce进行交互。你可以把它想象成一个桥梁，连接你的应用程序和Salesforce的数据。首先，REST API是“Representational State Transfer”的缩写，意思是“表现层状态转移”。听起来有点复杂，但其实很简单。它就是一种让不同的系统之间能够互相通信的方式。你可以通过它来读取、创建、更新或删除Salesforce中的数据。举个例子，假设你有一个外部的应用程序，比如一个移动应用，你想让这个应用能够访问Salesforce中的数据。这时候，你就可以使用REST API。你只需要发送一个HTTP请求，比如GET请求来获取数据，或者POST请求来创建新的记录。Salesforce会处理这个请求，并返回相应的数据或状态。 REST API非常灵活，支持多种数据格式，比如JSON和XML。JSON是最常用的格式，因为它轻量且易于解析。你可以通过REST API来操作Salesforce中的各种对象，比如客户、联系人、机会等等。另外，REST API还支持OAuth 2.0认证，这意味着你可以安全地授权第三方应用访问Salesforce数据，而不需要暴露你的用户名和密码。总结一下，Salesforce的REST API是一个非常强大的工具，它让你能够轻松地与Salesforce进行数据交互。无论你是想从外部系统读取数据，还是想把数据写入Salesforce，REST API都能帮你实现。好了，这就是关于Salesforce REST API的简单介绍。希望你能理解它的基本概念和用途。如果你有任何问题，随时问我！

查看详情

4

REST APIs: Scenario

第 260 页

今天我们来聊聊Salesforce中的REST API，特别是它在实际场景中的应用。REST API是一种基于HTTP协议的接口，它允许我们通过简单的HTTP请求与Salesforce进行交互。这种交互方式非常灵活，适用于多种场景。首先，想象一下你有一个移动应用，这个应用需要从Salesforce中获取客户数据。这时候，REST API就派上用场了。你可以通过发送一个GET请求到Salesforce的REST API端点，获取你需要的客户信息。这种方式非常高效，因为你可以只请求你需要的数据，而不是整个数据库。再比如，假设你有一个外部系统，需要将数据同步到Salesforce中。你可以使用REST API的POST请求，将数据发送到Salesforce，Salesforce会接收这些数据并存储在相应的对象中。这种方式非常适合需要频繁数据同步的场景。还有一种场景是，你可能需要从Salesforce中删除一些旧的数据。这时候，你可以使用REST API的DELETE请求，指定要删除的记录ID，Salesforce就会帮你处理掉这些数据。总的来说，REST API在Salesforce中的应用非常广泛，无论是数据获取、数据同步还是数据删除，它都能提供简单而强大的支持。希望这些例子能帮助你更好地理解REST API在实际工作中的应用。

查看详情

5

What is Representational State Transfer (REST)?

第 261 页

让我们来聊聊什么是代表性状态转移，也就是大家常说的REST。想象一下，你有一个非常聪明的邮递员，他负责在不同的房子之间传递信息。这个邮递员非常高效，因为他知道如何利用现有的道路和交通规则来快速送达信息。REST就像是这个邮递员，它是一种设计网络应用的方式，让不同的系统能够轻松地交换信息。现在，开发人员在使用REST API时，可以充分利用HTTP协议的全部功能。HTTP协议就像是邮递员使用的道路和交通规则。比如，HTTP缓存就像是邮递员记住经常走的路线，下次再走时就能更快到达。身份验证则像是邮递员需要出示身份证才能进入某些小区，确保信息的安全传递。而且，REST API允许开发人员直接使用所有的HTTP方法，比如GET、POST、PUT和DELETE。这些方法就像是邮递员可以使用的不同交通工具，比如自行车、摩托车或汽车，根据需要选择最合适的工具。而在SOAP API中，这些方法需要在SDF中重新定义，就像是邮递员每次都要重新申请使用交通工具的许可，这显然更麻烦。因此，REST API通常使得与移动设备、平板电脑和其他非传统客户端的集成变得更简单。就像邮递员能够轻松地将信息送到各种不同的房子，无论它们是高楼大厦还是乡村小屋。总结一下，REST是一种让不同系统轻松交换信息的方式，它利用了HTTP协议的全部功能，使得开发人员能够更简单、更高效地集成各种客户端。希望这个比喻能帮助你更好地理解REST的概念！

查看详情

6

REST Request Example

第 262 页

让我们来聊聊REST请求的一个实际例子。想象一下，你想要从一个叫做Google Geocoding API的服务获取一些地理信息。这个服务可以帮助你根据地址找到具体的地理位置。在REST风格的服务中，你不需要发送复杂的消息，比如SOAP消息。你只需要通过HTTP或HTTPS协议，简单地访问一个特定的URL就可以了。这个URL包含了所有必要的信息，比如你想要查询的地址。举个例子，如果你想要查询西班牙的托莱多市的地理信息，你可以使用这样的URL： ``` https://maps.googleapis.com/maps/api/geocode/json?address=托莱多&region=es&sensor=false ``` 这个URL可以直接粘贴到你的网络浏览器中。当你按下回车键，浏览器会向Google的服务器发送一个请求，然后服务器会返回一个JSON格式的响应，这个响应包含了托莱多市的地理信息。同样地，如果你想要查询美国的托莱多市，你可以使用这个URL： ``` https://maps.googleapis.com/maps/api/geocode/json?address=托莱多&region=us&sensor=false ``` 注意，这些URL实际上需要全部在一行上，没有中断。我们在这里为了更容易阅读，才把它们分成了多行。这就是REST请求的一个简单例子。你只需要一个URL，就可以获取到你想要的信息。这种方式非常直接和高效，是现在很多网络服务采用的方式。

查看详情

7

How is HTTP Used to Make a REST-Based API Call?

第 263 页

让我们来聊聊如何使用HTTP进行基于REST的API调用，以及它的工作原理。想象一下，你正在和朋友通过电话交流，你需要从朋友那里获取一些信息，或者告诉朋友一些新的信息。这个过程其实和API调用非常相似。首先，你需要创建一个HTTP请求。这个请求就像是你打电话时拨打的号码。在这个请求中，你需要指定一个方法，比如GET、POST等。GET方法就像是你在问朋友：“你能告诉我今天的天气吗？”而POST方法则像是你在告诉朋友：“我刚刚买了一本新书，书名是《Salesforce入门》。” 接下来，你需要在请求中加入授权信息，这就像是你在打电话时需要输入密码或者使用指纹解锁手机一样，确保只有你才能进行这次通话。这个授权信息通常放在请求头中。然后，你需要指定一个URI，这就像是你要拨打的电话号码，它告诉系统你想要联系的具体资源在哪里。如果你想要插入一些信息，比如在POST请求中，你还需要在请求实体中加入这些信息，这就像是你在电话中告诉朋友新书的详细信息。当你发送了这个请求后，系统会给你一个响应。这个响应就像是朋友在电话中回答你的问题或者确认收到了你的信息。这个响应中的数据，无论是你请求的信息还是错误信息，通常都是以JSON格式返回的。JSON格式就像是一种特殊的语言，它让数据在不同的系统之间能够被理解和交换。最后，Salesforce Platform REST API架构允许在客户端和资源之间存在代理服务器和网关等中介机构。这就像是你在打电话时，信号可能会通过多个基站传输，最终到达你的朋友那里。这些中介机构帮助确保请求能够安全、有效地到达目的地。这就是使用HTTP进行基于REST的API调用的基本过程。希望这个比喻能帮助你更好地理解这个过程！

查看详情

8

What is in a REST HTTP Request?

第 264 页

同学们，今天我们来聊聊REST HTTP请求中都包含哪些内容。首先，我们要知道，当我们向Salesforce发送一个REST HTTP请求时，有几个关键的部分是必须要有的。首先，我们需要一个OAuth 2.0的访问令牌。这个令牌是用来验证我们的身份的，确保我们有权限去访问Salesforce的数据。你可以通过OAuth 2.0的身份验证方法或者使用和SOAP API相同的会话ID方法来获取这个令牌。接下来，我们需要指定一个URI，也就是我们想要访问的资源的具体地址。这个URI会告诉Salesforce我们想要获取或者操作的是哪个资源。然后，我们还可以选择性地添加一个HTTP接受标头，这个标头是用来告诉Salesforce我们希望的资源格式是XML还是JSON。如果你不指定这个标头，你也可以在URI的末尾加上.json或者.xml来指定格式。不过，通常我们更倾向于使用JSON，因为它更轻量级，更容易阅读。最后，我们还需要指定一个HTTP方法，比如HEAD、GET、POST、PATCH或者DELETE。这些方法决定了我们对资源要执行的操作类型，比如是获取数据、创建新数据还是删除数据。除了这些必须的部分，我们的HTTP请求还可以包含一个JSON或者XML格式的请求体，这个请求体里面包含了我们请求所需的具体信息。举个例子，我们可以通过REST API来获取Salesforce的版本信息，或者获取某个对象（比如账户）的详细信息，甚至执行查询或者更新记录。 JSON，也就是JavaScript对象表示法，是一种非常流行的数据交换格式。它比XML更简洁，更容易阅读，而且几乎所有的现代编程语言都支持它。所以，在REST API中，我们通常会选择使用JSON来交换数据。好了，这就是今天关于REST HTTP请求内容的简单介绍。希望你们能有一个清晰的理解。如果有任何问题，随时提问哦！

查看详情

9

How Do You Specify the Representation of the Request or Response?

第 265 页

让我们继续聊聊如何在Salesforce的REST API中指定请求或响应的表示形式。首先，我们知道REST API支持OAuth 2.0身份验证，这是一种非常流行的安全协议，像Twitter和Facebook这样的应用都在使用。在使用REST API时，你需要先从OAuth服务器获取一个访问令牌，然后每次发送请求时都要带上这个令牌。这样，Salesforce就能识别出你是谁，并确保你有权限进行相应的操作。接下来，我们谈谈压缩。REST API允许你压缩请求和响应，这样可以减少数据传输的大小，提高效率。如果你使用的是支持HTTP 1.1的客户端，它可能已经自动支持压缩了。如果不支持，你也可以手动添加这个功能。为了使用压缩，你需要在请求的HTTP头中加入`Accept-Encoding: gzip`或`Accept-Encoding: deflate`。这样，如果客户端正确指定了这个头，REST API就会压缩响应。响应中会包含`Content-Encoding: gzip`或`Content-Encoding: deflate`的头信息。同样，你也可以通过包含`Content-Encoding: gzip`或`Content-Encoding: deflate`的头来压缩请求。最后，我们来看看数据的格式。REST API支持JSON格式，这是一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成。日期和时间信息采用ISO8601格式，这是一种国际标准，用于表示日期和时间。对于XML格式，REST API支持UTF-8和UTF-16编码的请求，而响应则只提供UTF-8格式的XML。希望这些信息能帮助你更好地理解如何在Salesforce的REST API中指定请求或响应的表示形式。如果你有任何问题，随时问我！

查看详情

10

How Do You Construct a Resource?

第 266 页

让我们来聊聊如何在Salesforce中构建资源，以及URL的一些小细节。首先，根URL，也就是我们常说的基本URL，它是我们访问Salesforce服务的起点。比如，`https://na1.salesforce.com` 就是一个典型的根URL。在这个基础上，我们会添加更多的路径来访问特定的资源或执行特定的操作。接下来，我们来看看URI中的对象名称。在Salesforce中，URI中的对象名称是不区分大小写的。这意味着，无论是 `/sobspel/Contact/` 还是 `/sobspel/touch/`，系统都会把它们当作同一个对象来处理。这给了我们一些灵活性，但也要注意，URI的其他部分，比如路径和查询参数，是区分大小写的。举个例子，假设我们有一个查询的URL： ``` https://na1.salesforce.com/services/data/v22.0/query?q=SELECT+id,名称+FROM+帐户+LIMIT+2 ``` 这个URL是有效的，它会执行一个查询，返回账户的ID和名称，最多返回两条记录。但是，如果你在服务中使用SEARCH时，同样的URL可能就不起作用了，因为SEARCH的语法和QUERY是不同的。为了让程序更友好，我们可以在操作失败时提供更多的信息。比如，如果查询不成功，程序可以返回一个状态码，并说明为什么失败。这样，开发者就能更快地找到问题所在。最后，根据案例#22068，我们对URL的解析做了一些调整。以前，整个查询部分（包括`?q=SELECT+id,名称+FROM+帐户+LIMIT+2`）都被识别为资源。现在，只有`/select`部分被标识为资源，其余部分则被视为有效负载。这样的调整使得URL的结构更加清晰，也更容易理解和维护。希望这些解释能帮助你更好地理解如何在Salesforce中构建资源和使用URL。如果有任何问题，随时问我！

查看详情

11

What is the Purpose of the HTTP Method?

第 267 页

让我们来聊聊HTTP方法的目的。HTTP方法，简单来说，就是告诉服务器你想要做什么。比如，GET方法就是用来获取数据的，POST方法则是用来创建新数据的。有时候，有些客户端可能不支持PATCH方法，这时候你可以用一个小技巧。你可以在POST请求的查询字符串里加上一个参数，比如“httpMethod=PATCH”，这样服务器就知道你其实是想用PATCH方法。再来说说案例#22069。在这个案例里，我们把POST方法的描述从“创建对象”改成了“创建记录”。这样做是为了和其他方法保持一致，让文档看起来更统一。最后是案例#22070。在这个案例里，我们删掉了所有HTTP动词后面的括号。因为这些括号并不是编程方法的一部分，去掉它们可以让文档更简洁明了。希望这些解释能帮你更好地理解HTTP方法的目的和使用技巧。如果有任何问题，随时问我哦！

查看详情

12

What Are the Response Status Codes?

第 268 页

让我们来聊聊响应状态代码和错误处理。想象一下，你正在和Salesforce系统进行对话，你发送了一个请求，比如查询一些数据。系统会回应你，告诉你它是否成功处理了你的请求，或者是否遇到了问题。当你发送的请求有问题时，Salesforce会通过HTTP代码来告诉你。在这个例子中，返回的HTTP代码是400。这个代码通常意味着“错误的请求”，也就是说，你发送的请求有格式错误或者逻辑错误，Salesforce无法理解或处理它。接下来，我们来看看响应体，也就是Salesforce给你的详细错误信息。这里有几个关键部分： 1. ，错误代码，：在这个例子中是“INvalID_TYKE”。这个代码告诉你具体是什么类型的错误。虽然这里的代码看起来有点奇怪，可能是拼写错误，但通常它会告诉你错误的性质，比如无效的类型、缺少必要的信息等。 2. ，错误消息，：这里有一条消息，告诉你具体的错误是什么。在这个例子中，消息指出在查询语句的第1行第23列有一个错误，涉及到对象类型“Account”。这通常意味着你在查询语句中可能拼写错误或者使用了不正确的语法。 3. ，发生错误的字段或对象，：在这个例子中，错误涉及到“Account”对象。这告诉你，问题出在你对“Account”对象的处理上。所以，当你看到这样的错误信息时，你应该检查你的查询语句，确保所有的对象名称和字段名称都是正确的，语法也是符合Salesforce的查询语言（SOQL）的规则。这样，你就可以修正错误，重新发送请求，得到你想要的正确数据了。

查看详情

13

What About Security and the REST APIs?

第 269 页

让我们来聊聊Salesforce的安全性和REST API。首先，REST API是一种非常流行的技术，它允许不同的应用程序通过网络进行通信。在Salesforce中，REST API支持一种叫做OAuth 2.0的身份验证模型。你可能已经在使用Twitter或Facebook时遇到过这种模型，它非常安全且易于使用。当使用OAuth 2.0进行身份验证时，首先会从OAuth服务器获取一个访问令牌。这个令牌就像是一把钥匙，每次你向Salesforce发送请求时，都需要带上这把钥匙。这个访问令牌必须放在请求的头部信息中，不能作为请求的参数直接传递，这样做是为了保证安全性。此外，Salesforce的REST API还支持另一种身份验证方法，叫做Salesforce会话ID。这种方法与SOAP API类似，也是通过会话ID来验证用户身份的。在Salesforce中，有一种特殊的用户设置叫做“仅限API”。这意味着这些用户只能通过API与Salesforce进行交互，而不能通过用户界面（UI）登录。这对于那些只需要通过程序与Salesforce交互的场景非常有用。最后，为了使用REST API，用户必须被“启用API”。这是一个必要的设置，确保只有授权的用户才能通过API访问Salesforce的数据。总结一下，Salesforce的REST API提供了强大的功能和严格的安全措施，确保数据的安全和正确使用。通过OAuth 2.0和会话ID等身份验证方法，Salesforce确保了只有授权的用户和应用程序才能访问其数据。

查看详情

14

What Makes the REST API Different Than the SOAP API?

第 270 页

让我们来聊聊REST API和SOAP API的区别。首先，REST API和SOAP API都是用来让不同的软件系统之间进行通信的，但它们的工作方式有些不同。 REST API，也就是“Representational State Transfer”，它使用HTTP协议的所有方法，比如GET、POST、PUT和DELETE。这意味着你可以直接用这些方法来请求数据或发送数据，而不需要像SOAP那样在XML中定义这些操作。这使得REST API在移动设备、平板电脑等非传统客户端上使用起来更加简单和直接。此外，REST API的协议比较轻量级，所以数据在网络上的传输速度通常更快。而SOAP API，也就是“Simple Object Access Protocol”，它使用XML格式来封装数据，这使得数据更加结构化，并且支持类型检查。SOAP在处理大量数据时表现得更好，因为它可以确保数据的完整性和安全性。总结一下，REST API更适合需要快速、简单集成的场景，特别是在移动设备上。而SOAP API则更适合需要处理大量数据，且对数据安全性和完整性要求较高的场景。希望这个解释能帮助你更好地理解REST API和SOAP API的不同之处。如果你有更多问题，随时欢迎提问！

查看详情

15

Module Agenda - 271

第 271 页

今天我们来聊聊Salesforce的REST API。REST API是一种非常流行的网络服务接口，它允许不同的应用程序通过互联网进行通信。Salesforce的REST API特别强大，因为它让你能够从外部系统访问和操作Salesforce中的数据。首先，REST代表“表述性状态转移”，它是一种设计风格，用于创建网络服务。Salesforce的REST API使用标准的HTTP方法，比如GET、POST、PUT和DELETE，来执行读取、创建、更新和删除操作。例如，如果你想从Salesforce获取一些数据，你可以发送一个GET请求到Salesforce的REST API端点。Salesforce会处理这个请求，并返回你所需的数据，通常是以JSON格式。 Salesforce的REST API非常灵活，支持多种数据格式，包括JSON和XML。这意味着你可以很容易地将Salesforce与其他系统集成，无论是移动应用、网站还是其他企业软件。此外，Salesforce的REST API还支持OAuth 2.0认证，这是一种安全的认证方式，确保只有授权的用户和应用程序可以访问数据。总之，Salesforce的REST API是一个强大的工具，可以帮助你轻松地扩展和集成Salesforce的功能。无论你是开发者还是业务用户，了解和使用REST API都将大大增强你与Salesforce的互动能力。希望这个简介能帮助你更好地理解Salesforce的REST API！

查看详情

16

REST API: Scenario

第 272 页

今天我们来聊聊Salesforce中的REST API，特别是它在实际场景中的应用。REST API是一种非常强大的工具，它允许不同的应用程序之间进行通信和数据交换。想象一下，你有一个Salesforce系统，还有一个外部的应用程序，比如一个移动应用或者一个网站。你希望这个外部应用能够访问Salesforce中的数据，或者向Salesforce发送数据。这时候，REST API就派上用场了。举个例子，假设你有一个电商网站，用户在网站上下了订单。你希望这个订单信息能够自动同步到Salesforce中，这样你的销售团队就可以及时跟进。通过REST API，你的网站可以发送一个HTTP请求到Salesforce，包含订单的详细信息。Salesforce接收到这个请求后，会处理这些数据，并将其存储在相应的对象中，比如订单对象。再比如，你的销售团队在Salesforce中更新了客户的信息，你希望这些更新能够实时反映在你的客户关系管理系统中。通过REST API，Salesforce可以发送一个请求到你的CRM系统，告知它客户信息已经更新。这样，你的CRM系统就可以及时同步这些变化，确保数据的一致性。总的来说，REST API在Salesforce中的应用场景非常广泛，无论是数据同步、信息更新，还是系统集成，它都能发挥重要作用。希望这个简单的解释能帮助你更好地理解REST API在实际中的应用。

查看详情

17

What is the REST API?

第 273 页

让我们来聊聊REST API。想象一下，REST API就像是一座桥梁，它连接了不同的系统，让它们能够互相交流。在Salesforce的世界里，REST API就是这座桥梁，它允许外部系统访问Salesforce的数据和功能。 REST API是以数据为中心的，这意味着它主要关注的是数据的传输和操作。它使用了一种非常轻量级的协议，这意味着数据传输非常快速和高效。你可以把它想象成是一种快递服务，它能够快速、准确地将数据从一个地方送到另一个地方。在REST API中，数据可以以多种格式表示，最常见的是JSON和HTML。JSON是一种非常流行的数据格式，因为它既轻量又易于阅读和编写。HTML则是我们用来构建网页的语言，它也可以用来在REST API中传输数据。所以，简单来说，REST API就是一种让不同系统之间能够轻松交换数据的方式，它使用轻量级的协议和多种数据格式，使得数据传输既快速又灵活。在Salesforce中，REST API是一个非常重要的工具，它帮助我们更好地管理和利用数据。

查看详情

18

What is the REST API? - 274

第 274 页

让我们来聊聊REST API。REST API是一种网络服务，它允许不同的软件应用程序通过互联网进行通信。想象一下，你有一个手机应用，它需要从Salesforce获取一些客户数据。REST API就是那个桥梁，它让你的应用能够请求这些数据，并且Salesforce能够理解并响应这个请求。现在，让我们看看你提到的URL。这个URL是用来向Salesforce请求数据的。它包含了一些信息，比如你想要查询的数据类型（在这个例子中是“帐户”），以及你想要获取的字段（比如“id”和“名称”）。这个URL还包含了一个版本号（v24.0），这告诉Salesforce你使用的是哪个版本的API。你提到的“limit+2”部分是用来限制返回的结果数量的。在这个例子中，它意味着你只想获取前两个帐户的数据。如果你去掉这部分，Salesforce就会返回所有匹配的帐户数据，这可能会非常多。所以，简单来说，REST API是一种让不同软件之间交流的方式，而URL则是你用来告诉Salesforce你想要什么数据的“地址”。通过调整这个URL，你可以控制你获取的数据类型和数量。希望这解释清楚了REST API的基本概念！

查看详情

19

How Do You Get the Next Batch of Records?

第 275 页

让我们来聊聊如何在Salesforce中获取下一批记录。假设你已经执行了一个查询，并且这个查询返回了很多记录，多到一次无法全部显示。这时候，Salesforce会给你一个叫做`nextRecordsUrl`的链接，这个链接就是用来获取下一批记录的。你提到的链接看起来像这样： ``` https://na#.salesforce.com/services/data/v27.0/query/01g3000000lNpqhAAC-4000 ``` 这个链接中的`01g3000000lNpqhAAC-4000`部分就是`nextRecordsUrl`。你只需要把这个链接复制下来，然后在你的请求中使用它，就可以获取到下一批记录了。具体操作很简单，你不需要添加任何额外的参数，直接把这个链接放到你的请求中就可以了。Salesforce会自动处理这个请求，并返回下一批记录给你。总结一下，当你需要获取下一批记录时，只需要使用`nextRecordsUrl`这个链接，不需要添加任何参数，Salesforce会帮你处理剩下的部分。这样，你就可以轻松地获取到所有的记录了。希望这个解释对你有帮助！

查看详情

20

How Do You Perform a Create?

第 276 页

同学们，今天我们来聊聊如何在Salesforce中使用HTTP Post请求来创建一个新的记录。这个过程其实很简单，我们只需要做两件事：指定我们要插入的对象类型，以及提供这个对象的具体数据。首先，我们来看一下URL部分，也就是1A。这个URL是Salesforce提供的一个端点，用来接收我们的请求。在这个例子中，`https://na14.salesforce.com/services/data/v20.0/sobjects/Account/` 这个URL告诉Salesforce我们要操作的对象是“Account”，也就是客户账户。`v20.0` 表示我们使用的是API的第20.0版本。接下来，我们来看一下请求体部分，也就是1B到4B。这里我们定义了一个JSON对象，它包含了我们要插入的新账户的具体信息。在这个例子中，我们创建了一个名为“银河世界移动者”的账户，并且提供了联系电话“(415) 222-3333”。所以，总结一下，我们通过HTTP Post请求，向Salesforce发送一个包含新账户信息的JSON对象，Salesforce就会根据这个信息创建一个新的账户记录。这个过程非常直接，只需要确保你的URL和请求体格式正确就可以了。希望这个解释对你们有帮助，如果还有任何疑问，随时提问哦！

查看详情

21

How Do You Perform an Update or Upsert?

第 277 页

让我们来聊聊如何在Salesforce中执行更新操作。这里我们使用的是HTTP的PATCH方法，这是一种用来更新资源部分内容的方法。我们以更新一个账户（Account）的电话号码为例。首先，你需要知道你要更新的对象的ID。在这个例子中，对象的ID是`001d000000CaHv9AAF`。这个ID是Salesforce自动生成的，每个对象都有一个唯一的ID。接下来，你需要构建一个HTTP请求。这个请求的URL会指向Salesforce的API端点，具体到这个例子，URL是`https://na14.salesforce.com/services/data/v20.0/sobjects/Account/001d000000CaHv9AAF`。这里，`Account`是对象的类型，`001d000000CaHv9AAF`是对象的ID。然后，你需要在请求的body中提供你想要更新的数据。在这个例子中，我们想要更新的是电话号码。所以，body中的数据看起来是这样的： ```json { "Phone": "(415) 222-3333" } ``` 注意，这里的键（`Phone`）是Salesforce中字段的API名称，值（`(415) 222-3333`）是你想要更新的新电话号码。最后，你发送这个PATCH请求到Salesforce。如果一切顺利，Salesforce会返回一个成功的响应，告诉你更新已经完成。总结一下，更新Salesforce中的对象，你需要知道对象的ID，构建一个包含更新数据的HTTP PATCH请求，然后发送这个请求到正确的API端点。希望这个解释对你有帮助！

查看详情

22

How Do You Perform a Delete?

第 278 页

同学们，今天我们来聊聊如何在Salesforce中执行删除操作，特别是通过HTTP请求来删除一个特定的记录。首先，我们需要明确几个关键点： 1. ，对象类型，：这是你要删除的记录所属的对象类型，比如“Account”代表客户。 2. ，对象ID，：这是你要删除的记录的唯一标识符，每个记录在Salesforce中都有一个独特的ID。现在，假设我们有一个客户记录，它的ID是`001d000000CaHv9AAF`，我们想要删除这个客户记录。我们可以使用HTTP的DELETE方法来执行这个操作。具体的URL格式是这样的： ``` https://na14.salesforce.com/services/data/v24.0/sobjects/Account/001d000000CaHv9AAF ``` 这里，`na14.salesforce.com`是你的Salesforce实例的域名，`v24.0`是API的版本，`Account`是对象类型，`001d000000CaHv9AAF`是你要删除的记录ID。执行这个删除操作的步骤如下： 1. ，构建URL，：将上述URL中的实例域名、API版本、对象类型和对象ID替换为你实际的值。 2. ，发送HTTP DELETE请求，：使用任何支持HTTP请求的工具（如Postman）或编程语言（如Python的`requests`库），向这个URL发送一个DELETE请求。 3. ，处理响应，：如果删除成功，Salesforce会返回一个HTTP状态码204（No Content），表示记录已被成功删除。记住，删除操作是不可逆的，所以在执行之前一定要确认你真的想要删除这条记录。希望这个解释对你们有帮助！如果有任何疑问，随时提问。

查看详情

23

What About Submitting Multiple Requests?

第 279 页

让我们来聊聊Salesforce中的批量资源功能。这个功能非常有用，特别是当你需要同时处理多个请求时。想象一下，你有一个任务列表，你不想一个一个地去完成，而是想一次性完成多个任务。批量资源功能就是帮你实现这个想法的。具体来说，批量资源允许你在一个请求中发送多个独立的子请求。这样做的好处是，你可以减少与服务器之间的往返次数，从而提高效率。比如，你可以同时更新一个账户的名称，并且获取这个账户的某些字段值，所有这些操作只需要一个请求就可以完成。举个例子，假设你有一个账户，你想把它的名字从“旧名称”改成“新名称”，同时你还想获取这个账户的某些信息，比如它的地址或者电话号码。使用批量资源功能，你可以在一个请求中完成这两件事，而不需要分别发送两个请求。这个功能是在2015年夏天推出的，所以如果你是在那之后开始使用Salesforce的，你可能已经用过了。如果你对这个功能感兴趣，想了解更多细节，可以访问Salesforce的帮助中心，那里有详细的指南和示例。总之，批量资源是一个强大的工具，可以帮助你更高效地处理多个请求，节省时间，提高工作效率。希望这个解释对你有帮助！

查看详情

24

The REST Explorer

第 280 页

今天我们来聊聊一个有趣的概念——“休息探索者”。听起来是不是有点新鲜？其实，这个词是用来形容那些在忙碌的工作或学习之余，懂得如何有效地休息和放松自己的人。想象一下，你是一个探险家，每天都在探索未知的领域，解决各种问题。但即使是再勇敢的探险家，也需要停下来，搭个帐篷，生个火，享受一下宁静的夜晚。这就是“休息探索者”的精髓——在探索的过程中，不忘给自己充电。那么，如何成为一个优秀的“休息探索者”呢？首先，你需要认识到休息的重要性。休息不是懒惰，而是为了走得更远。其次，找到适合自己的休息方式。有人喜欢散步，有人喜欢听音乐，还有人喜欢冥想。关键是找到让你感到放松和愉悦的活动。最后，别忘了给自己设定休息的时间。就像探险家会规划路线一样，你也可以规划你的休息时间。比如，每工作一小时，休息十分钟。这样，你就能在忙碌的生活中，找到属于自己的宁静时刻。所以，下次当你感到疲惫时，不妨试试成为一位“休息探索者”，给自己一个放松的机会，你会发现，休息后的你，会更加充满活力，准备好迎接新的挑战。

查看详情

25

Module Review

第 282 页

让我们继续深入了解一下这个模块ReviewRequestResponse以及如何使用原生的HTTP来进行数据交换。这个模块支持JSON和XML两种格式，这使得它非常适合与移动设备、平板电脑以及其他非传统客户端进行集成。使用这些格式可以确保数据交换的灵活性和广泛兼容性。接下来，我们谈谈OAuth。OAuth是一种开放标准的授权协议，允许用户授权第三方应用访问他们存储在另外的服务提供者上的信息，而无需将用户名和密码提供给第三方应用。这对于保护用户数据的安全非常重要。现在，让我们看看一些具体的实现细节。首先，关于获取证书提供程序的方法getCredentialsProvider()，这个方法已经被标记为弃用。这意味着虽然它现在还能用，但未来的版本可能会移除它，所以建议使用更新的方法来替代。关于设置证书的方法SetCredentials，它需要两个参数：AuthScope和Credentials。AuthScope类有多个构造函数，其中一个允许你指定主机和端口。而UsernamePasswordCredentials是一个实现了Credentials接口的类，用于处理用户名和密码的认证。最后，我们来看一下HttpHost类。这个类包含了描述到主机的HTTP连接所需的所有变量，包括远程主机名、端口和方案。构造函数HttpHost(String hostname, int port)允许你指定主机名和端口号，其中主机名可以是IP地址或DNS名称，端口号则是用于连接的端口。这些知识点对于理解和使用ReviewRequestResponse模块非常重要，希望这些信息能帮助你更好地掌握如何使用原生HTTP进行数据交换。如果有任何疑问，随时可以提问！

查看详情

26

Summarize It! - 283

第 283 页

我们来总结一下前面提到的内容。首先，我们提到了一个叫做 `ConnRoutePNames` 的公共接口，它主要用于定义连接路由的参数名称。不过，这个接口已经被标记为“废弃”了，也就是说，它不再推荐使用。特别是其中的 `DEFAULT_PROXY` 参数，它用于设置默认代理，但现在有更好的方法来处理代理设置。接下来，我们介绍了一种新的方法来设置代理。你可以通过创建一个 `HttpHost` 对象来指定代理的地址和端口，比如 `new HttpHost("someproxy", 8080)`。然后，你可以使用 `DefaultProxyRoutePlanner` 来设置路由规划器，并通过 `HttpClients.custom().setRoutePlanner(routePlanner).build()` 来构建一个 `CloseableHttpClient` 对象。这种方法更加现代和灵活。最后，我们还提到了一些你可能需要用到的库文件，比如 `commons-logging-1.1.1.jar`、`json-20110202.jar` 等等。这些库文件是为了支持你在使用新的代理设置方法时所需的功能。总的来说，虽然旧的 `ConnRoutePNames` 接口已经被废弃，但新的方法提供了更强大和灵活的方式来处理代理设置。希望这些信息对你有帮助！

查看详情

27

Trailhead Homework - 284

第 284 页

同学们，今天我们来聊聊Salesforce的Trailhead平台上的一个非常实用的模块——API基础。这个模块特别适合那些想要深入了解Salesforce如何通过API与外部系统交互的同学。首先，API是什么呢？简单来说，API就像是一个桥梁，它允许不同的软件系统之间进行沟通和数据交换。在Salesforce中，API让我们能够从外部系统获取数据，或者将Salesforce中的数据发送到其他系统。在这个模块中，你们将学习到REST API的基础知识。REST API是一种常用的网络API，它使用标准的HTTP方法，比如GET、POST、PUT和DELETE，来执行操作。这些操作可以帮助你创建、读取、更新或删除Salesforce中的数据。这个模块是作为家庭作业来设计的，意味着你们需要在课后自己完成。这样做的好处是，你们可以根据自己的节奏来学习，遇到不懂的地方可以反复观看教程，或者查阅相关资料。完成这个模块后，你们将能够理解如何使用REST API与Salesforce进行交互，这将大大增强你们在Salesforce开发中的能力。所以，记得课后花时间去Trailhead上完成这个模块，这对你们未来的学习和工作都会有很大的帮助。好了，这就是今天的教学内容。希望你们能够通过这个模块，更好地掌握Salesforce的API知识。加油！

查看详情

DEX502

课程介绍

课程章节