基本的 CRUD 操作

首先,确保你登录 ,并将 access_token 添加到你的请求标头中。

在此示例中,我们将执行一些基本操作来访问记录。这些使用 Accounts 模块作为示例,但其他标准和自定义模块(即 Leads,Contacts,Opportunities)的行为方式相同。

创建

要创建帐户,我们需要向 Accounts 端点发送一个发布请求,其中包含我们要添加的详细信息。成功后,将返回包含新记录的 ID 和当前数据的对象。

POST https://YOURSITE.com/rest/v10/Accounts
{
"name":"My New Account"
}

首先,我们将检索刚刚创建的记录,对我来说,Id 是“9174c58c-409c-11e7-bfdf-00163ef1f82f”,因此要检索记录的所有信息,我们执行以下操作:

GET https://YOURSITE.com/rest/v10/Accounts/9174c58c-409c-11e7-bfdf-00163ef1f82f

那肯定是一个大对象! 怎么看到这个名字,以及我刚创建的日期呢?

GET https://YOURSITE.com/rest/v10/Accounts/9174c58c-409c-11e7-bfdf-00163ef1f82f?fields=name,date_entered

好多了。但是,如果我已经在系统中拥有数千个帐户,并且还没有设法记住它的 GUID 怎么办?

GET https://YOURSITE.com/rest/v10/Accounts?fields=name,date_entered&filter[0][name]=My New Account

更新

那么,如果我决定要在应用程序上更改某些内容呢?如何更改名称和添加说明?

PUT https://YOURSITE.com/rest/v10/Accounts/9174c58c-409c-11e7-bfdf-00163ef1f82f
{
    "name":"My Updated Account",
    "description":"Updated via REST API"
}

删除

好的,这一切都很好,但是在将实际数据放入之前让我们清楚这一点:

DELETE https://YOURSITE.com/rest/v10/Accounts/9174c58c-409c-11e7-bfdf-00163ef1f82f