Index
ファイルアップロード
添付ファイルフィールドにファイルをアップロードするAPIです。
- アップロードされたファイルのファイルキーを利用して、レコード登録やレコード更新などで利用できます。
- 一度にアップロードできるファイルは、一つです。
HTTP メソッド
POST
URI
https://(サブドメイン名).cybozu.com/k/v1/file.json
ゲストスペース内のアプリの場合
https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/file.json
リクエスト形式
- リクエストは multipart/form-data 形式で送信します。 詳細は RFC1867、RFC2388 を参照してください。
- Content-Disposition 内の name には「file」、filename にはファイル名を指定してください。
※日本語ファイル名の場合は UTF8 でエンコードした内容を指定して下さい。
リクエストの例
リクエストヘッダを含んだ例）
ファイル内容が「test」の test.txt ファイルを送信した場合
POST /k/v1/file.json HTTP/1.1 Host: example.cybozu.com:443 X-Cybozu-Authorization: cnlvX2Z1a3VkYTpjeWJvenU= Content-Type: multipart/form-data; boundary=---------------------------bee48a285354 Content-Length: 188 -----------------------------bee48a285354 Content-Disposition: form-data; name="file"; filename="test.txt" Content-Type: text/plain test -----------------------------bee48a285354--
レスポンスの例
アップロードされたファイルのファイルキーが返されます。 ファイルキーは、レコード登録やレコード更新を行なう API で添付ファイルフィールドの値として使用します（後述）。
アップロードしたファイルとレコードの関連付け
取得したファイルキーを、登録や更新の API 実行時に、添付ファイルフィールドの値として、以下のように使用します。
リクエストヘッダ(レコード更新 API 使用時の場合)
PUT /k/v1/record.json HTTP/1.1 Host: example.cybozu.com:443 X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
- Content-Type に application/json を指定して下さい。 指定しない場合は JSON が解釈できないため、実行時エラーとなります。
ボディ(レコード更新 API 使用時の場合)
制限事項
- アップロードされたファイルは、レコード登録 API やレコード更新 API によってレコードに添付しない場合には、3日間で削除されます。
- 一時保管領域に保管された状態のファイルも、ディスク使用量に含まれます。
その他につきましては、共通仕様の制限事項 をご確認ください。
関連Tips
JavaScriptサンプル
XMLHttpRequest
name="file" は固定の様子。他の値だとCB_IL02が返ってくる。
すでにKintone上にアップしたいファイルを、他のアプリにもアップロードしたいのですが、レコードの取得APIで取得した添付ファイルのファイルキーをレコード更新APIのボディにセットして使うことは可能でしょうか。
AD様
コメントありがとうございます。developer network事務局です。
はい、下記のようなイメージで利用可能です。
参考：ファイルアップロードのAPIドキュメント
ファイルダウンロードとアップロードに関する記事もありますので、是非参考にしていただけたらと思います。
・ファイルダウンロードで必須となる2つの手順
・ファイルアップロードで必須となる3つの手順
今後共よろしくお願い致します。
IDとパルワードが流出された時に、Kintone上のデータとアタッチメントは簡単にダウンロードされます。
もしファイル(PDF,Word,Excel)をアップロードする際に、自動暗号化ツールを使って、暗号化されたファイルで保存するのは可能でしょうか？
そうするとあるIPアドレス以外の人がダウンロードしても、ファイルが見えない状態になります。
こういうようなツールは何かがありますか？
yihung様
恐れ入りますが、ファイルアップロードのAPIへのフィードバックと異なるご質問のため、コミュニティにて投稿をお願いします。
また、よろしければ、製品への要望としてお送りください。
kintoneのポータルから「？」マーク->「kintoneの改善に協力」で送信することが可能です。