基本的 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