# Connect Postman to Salesforce

示範如何利用 Postman 連接到 Salesforce ，並發送 REST API 請求

---

## Setup

### 取得帳號/密碼

若是使用 Trailhead Playground，可以到 Setup > Users 重置密碼，之後 Postman 會透過 redirect URL 進行登入取得授權

> 已經有的可以跳過這步驟

### 開啟 Cross-Origin Resource Sharing (CORS) 白名單

CORS 可以允許透過特定 domain name，利用 web browser 向 Salesforce 請求資源

設定方法是到 Setup， Quick Find 輸入 cors


點選 New 加入以下兩個 origin URL:

* https://*.postman.com

* https://*.postman.co


---

## Connect

接下來要設定 Postman

首先要登入 Postman 帳號，沒有的可以先[註冊](https://identity.getpostman.com/signup)

接著建立一個新的 `Workspace`


因為是個人開發用，所以 Visibility 選擇 `Personal`


之後我們要去 [Salesforce Developer workspaces](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/overview)， fork 他們提供的 collection

我們的目標是 `Salesforce APIs`


接著點右上方的 Fork icon


`Location` 指定到我們剛剛建立的 workspace


fork 下來後，可以看到 colletion 的內容，但在測試 API 之前，我們要先取得 Salesforce 的授權

在 `Authorization` tab 進行設定，`type` 選擇 `OAuth 2.0`.，然後拉到最下方的 `Get New Access Token`


這裡注意到，預設是使用 browser authorization，callback URL 看起來是 Postman 官方提供的

按下按鈕後 browser 會跳到 Salesforce Access Page ，按下 `Allow`


這邊要注意， Postman callback URL 是彈出式的視窗，若是瀏覽器有阻擋彈出視窗，記得手動打開


callback URL page ，允許吧


跳回到 Postman，可以看到認證完成，按下 Proceed 取得授權


這邊的 `Access Token` 就是用來向 Salesforce 請求資源的依據，可以先複製起來，另外 `instance_url` 也記一下


到 collection 的 `Variables` tab 將剛才的 token url 存到變數中

> url 對應到 _endpoint

完成後，測試一下 API

選擇 Rest > Limits ，查看當日的租戶分配到的資源上限及剩餘數量


後續就可以將我們自行開發的 Apex REST API 也加到 colletion 裡，方便開發及測試

###### tags: `Salesforce` `Apex` `postman`