上傳CSV檔案
將檔上傳到臨時存儲。
臨時存儲是臨時存儲使用此 API 上傳的檔的臨時存儲位置。
- 通過將上傳檔的檔案金鑰與其他 API 一起使用,您可以將臨時存儲中的檔案附加到記錄、空間等。
- 您一次只能上傳一個檔。
- 可以使用 API 檢索記錄的檔案金鑰不可用於檔案上傳。
URL
- 常規應用
- https://sample.cybozu.com/k/v1/file.json
- 建立訪客空間
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/file.json
HTTP 方法
POST
所需許可權
無
關於上傳檔的訪問許可權,請參考 用於附加檔的 API 所需的許可權,例如用於註冊/更新記錄的 API。
請求
- 請求以 multipart/form-data 格式發送。 有關詳細資訊,請參閱 RFC 1867 和 RFC 7578。
- 為"Content-Disposition "指定"file",
filename
為"Content-Dispositionname
"指定檔名。
對於日語檔名,請指定UTF-8編碼的內容。
參數
無
示例請求
URL
https://sample.cybozu.com/k/v1/file.json
頁眉
|
|
關於請求頭,請參見 kintone REST API的通用規範 。
HTTP 標頭資訊
|
|
回應
財產
屬性名稱 | 型 | 說明 |
---|---|---|
fileKey | 字串 | 上傳檔的文件金鑰 檔鍵用作用於附加檔的 API 中附件欄位的值。 有關詳細資訊,請參閱欄位格式 。 |
示例回應
|
|
示例代碼
使用 curl 的請求
|
|
使用 Fetch API 的請求
|
|
檔鍵
有兩種類型的「檔案金鑰」用於上傳和下載檔:
- 要獲取的文件金鑰以回應
上傳檔 API
- 例:
c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6
- 例如,用於將存儲在臨時存儲中的檔與附件欄位相關聯。
- 可以使用此 API 獲取的檔案金鑰。
- 例:
- 檢索記錄
的 API 可以獲取的附件的檔案金鑰
- 例:
201202061155587E339F9067544F1A92C743460E3D12B3297
- 例如,從附件欄位下載檔時會使用它。
- 它不是可以使用此 API 檢索的文件金鑰。
- 例:
限制
- 該介面不能 通過發送kintone REST API請求的API 執行。
- 如果存儲在臨時存儲中的檔未附加到記錄、空間等,則會在三天后刪除。
- 臨時存儲中的檔也包含在磁碟使用量中。