將執行外部 API 所需的資訊儲存在外掛程式。
從外掛程式執行外部 API 時，將此 API 儲存的資訊添加到請求的標頭和正文中。

如果要在執行外部 API 時使用保密資訊（例如身份驗證資訊），請事先使用此 API 將所需資訊存儲在外掛程式中。

此 API 只能在外掛程式設定畫面中運行，該畫面僅供應用程式管理員訪問。
這樣可以防止應用程式的使用者存取外掛程式中儲存的資訊。

PC

kintone.plugin.app.setProxyConfig(url, method, headers, data, successCallback)

如果指定的 URL 和 HTTP 方法組合已存在，它將覆蓋外掛程式設置。

{
  "key1": "value1",
  "key2": "value2"
}

無

PC

• 外掛程式的設定畫面

行動用戶端

無

將儲存的資訊添加到請求的條件

• 使用 從外掛程式執行外部 API 發送的請求時，當滿足以下所有條件時，外掛程式中儲存的資訊將添加到請求中：

  • 相同該應用程式
  • 相同的外掛程式
  • 相同的 HTTP 方法
  • 要執行的 API 的 URL 的開頭部分匹配 ^*1
    URL 區分大小寫。

• 如果在外掛程式中存儲了多個設定，則優先使用與執行 API 時指定的 URL 匹配度較高的 URL。
  例如，如果您在此 API 中指定以下 URL 或請求標頭：

  • 設定 1
    • URL：https://api.example.com/
    • 標頭：{ "Content-Type": "application/x-www-form-urlencoded" }
  • 設定 2
    • URL：https://api.example.com/foo/
    • 標頭：{ "Content-Type": "application/json" }

  指定以下值，執行 從外掛程式執行外部 API。

  • URL："https://api.example.com/foo/operate.json"
  • 標頭：{}

  在這種情況下，執行 API 時送出的請求的標頭是{ "Content-Type": "application/json" } 。