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

電腦/行動裝置

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

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

如果指定 successCallback ，則沒有返回值。
如果省略參數successCallback之後的內容，則返回Promise物件。
這允許您使用 async/await 來處理異步處理。

如何使用回調進行編寫

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

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

// 使用Promise物件的編寫方法

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

try {
  const [body, status, headers] = await kintone.proxy(
    'https://api.example.com',
    'GET',
    {},
    {}
  );
  // success
  console.log(status, body, headers);
} catch (error) {
  // error
  console.log(error); // 顯示代理 API 的回應內文（字串）
}

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

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