從 kintone 執行外部服務的 API。
此 API 允許您繞過跨域限制並向外部 API 發送請求。 要從外部上傳檔，請參閱 上傳檔案到外部。

PC/行動用戶端

kintone.proxy(url, method, headers, data, successCallback, failureCallback)

{
  "Content-Type": "application/json"
}

如果指定 successCallback，則沒有返回值。
如果省略 successCallback 參數，則返回 kintone.Promise 物件。

如何使用回調進行編寫

1
2
3
4
5
6
7

kintone.proxy('https://api.example.com', 'GET', {}, {}, (body, status, headers) => {
  // success
  console.log(status, JSON.parse(body), headers);
}, (error) => {
  // error
  console.log(error); // 顯示代理 API 的回應正文（字串）
});

如何使用 kintone.Promise 物件編寫

1
2
3
4
5
6
7
8

try {
  const resp = await kintone.proxy('https://api.example.com', 'GET', {}, {});
  // success
  console.log(resp);
} catch (error) {
  // error
  console.log(error);
}

• 如果指定的伺服器 url 不存在，則返回狀態代碼為"503"（DNS 快取缺失）的錯誤。
• 如果設置了IP位址限制，要使用該 JavaScript API 為同一域的其他應用執行 kintone REST API，則必須允許 kintone 的 IP 位址。
  有關 IP 位址的詳細資訊，請參閱 cybozu.com使用的網域及IP位址 。
  但是，從安全角度來看，不建議這樣做，因為它允許通過執行外部 API 的 API 從所有 kintone 環境自由訪問。
  如需向同一域發出請求，請使用 發送 kintone REST API 請求的 API。
• 即使您使用此 API 執行外部 API，也不會自動發出應由執行的 API 目標發出的 cookie。
• 如果為 HTTP 方法指定 POST 或 PUT，則會自動追加"Content-Length"和"Transfer-Encoding"標頭。
  如果在請求裡指定，則會出現錯誤。
• 可以使用的"Content-Type"沒有限制。

• 以下是對執行的外部 API 回應的限制：
  • 響應標頭的最大為 100 行，每行的最大長度為 8,180 位元組。
  • 回應正文的上限為 10MB。如果超過限制，則會發生錯誤。
  • 回應正文僅支援字串。無法檢索二進位數據，例如圖像。
• 不能使用自證書與伺服器通信。