上傳檔案到外部
從 kintone 上傳檔案到外部服務。
此 API 允許您繞過跨域限制並向外部服務發送請求。
函數
電腦/行動裝置
kintone.proxy.upload(url, method, headers, data, successCallback, failureCallback)
參數
參數 | 類型 | 必須 | 說明 |
---|---|---|---|
url | 字串 | 必須 | 請求 URL |
method | 字串 | 必須 | HTTP 方法 指定以下值之一:
|
headers | 物件 | 必須 | 請求標頭 例: {如果不指定任何內容,請指定 {} 。 |
data | 物件或字串 | 必須 | 請求內文 |
data.format | 字串 | 必須 | 要上傳的檔案的格式 只能指定「RAW」。 |
data.value | Blob 類型(包括檔案類型) | 必須 | 要上傳的文件中的數據 可指定的最大大小為 200MB。 |
successCallback | 函數 | 可省略 | 請求完成時執行的回調函數 以下資訊將傳遞給回調函數的參數:
kintone.Promise 物件,並將其解析為包含回應內文、狀態代碼和回應標頭的陣列。kintone.Promise 物件 |
failureCallback | 函數 | 可省略 | 請求失敗時執行的回調函數 如果省略,返回 kintone.Promise 物件,並會在代理 API 的回應內文(字串)中廢棄。kintone.Promise 物件 |
返回值
如果指定 successCallback
,則沒有返回值。
如果省略參數successCallback
,則返回kintone.Promise
物件。
kintone.Promise
物件
示例代碼
如何使用回調進行編寫
|
|
如何使用 kintone.Promise 物件編寫
|
|
注意事項
- 如果指定的伺服器
url
不存在,則返回狀態代碼為「503」(DNS 快取缺失)的錯誤。 - 如果設置了 IP 位址限制,要使用該 JavaScript API 為同一域的其他應用執行 kintone REST API,則必須允許 kintone 的 IP 位址。
有關詳細的IP地址,請參閱以下頁面。
cybozu.com 使用的域和IP位址
但是,從安全角度來看,不建議這樣做,因為它允許通過執行外部 API 的 API 從所有 kintone 環境自由訪問。 - 即使您使用此 API 執行外部 API,也不會自動發出應由執行的 API 目標發出的 cookie。
- 如果為 HTTP 方法指定 POST 或 PUT,則會自動追加「Content-Length」和「Transfer-Encoding」標頭。
如果在請求裡指定,則會出現錯誤。 - 可以使用的「Content-Type」沒有限制。
限制事項
- 以下是對執行的外部 API 回應的限制:
- 響應標頭的最大為 100 行,每行的最大長度為 8,180 位元組。
- 回應內文的上限為 10MB。如果超過限制,則會發生錯誤。
- 回應內文僅支援字串。無法獲取二進位數據,例如圖像。
- 不能使用自證書與伺服器通信。
- 目標瀏覽器基於以下頁面的內容。
操作環境中的 Web 瀏覽器