ファイルアップロードAPI
各種 CSV ファイルをアップロードする際に使用する API です。
HTTPメソッド
POST
URI
https://{sub-domain}.cybozu.com/v1/file.json
リクエストヘッダ
ヘッダ | 値と説明 |
X-Cybozu-Authorization | 「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。 |
Authorization | Basic認証を利用している場合、文字列「Basic 」と「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。 |
Content-Type |
|
リクエストサンプル
※ ファイル内容が「User1,User1,User1,password」のusers.csvファイルを送信した場合
//Sample X-Cybozu-Authorization: cnlvX2Z1a3VkYTpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: multipart/form-data; boundary=---------------------------bee48a285354 Content-Length: 215 -----------------------------bee48a285354 Content-Disposition: form-data; name="file"; filename="users.csv" Content-Type: text/csv User1,User1,User1,password -----------------------------bee48a285354--
※マルチバイト文字列は UTF-8 エンコードで記述します。
※各種 CSV ファイルのフォーマットは、 CSV のフォーマット をご確認ください。
レスポンス
アップロードされたファイルのファイルキーが返されます。
アクセス権
cybozu.com共通管理者のみ実行できます。
制限事項
- ユーザーインポートなどのインポート API を使って、アップロードしたファイルをインポートしなかった場合には、3日間でファイルが削除されます。
- 一時保管領域に保管された状態のファイルも、ディスク使用量に含まれます。
Cyobozuの仕様の質問になりますが、
apiを使用してアップロードしたファイルは、
ある程度の期間が経てば消えてしまうものなのでしょうか。
それとも、データとして容量にカウントされるものなのでしょうか。
共通管理のファイルからの読み込みも同様でしょうか。
teranaka様
お世話になります。
遅くなって申し訳ありませんが、お問い合わせの背景もご教示いただけますか。
よろしくお願いいたします。
本件は、ローカルからkintoneへファイルをアップロードするAPIである認識です。
その際のJavaScriptサンプルソース等も提示いただけると分かりやすいかと思います。
FireStorm 様
お世話になっております。cybozu developer network 運営局です。
こちらは .com 共通管理の API で、ユーザー情報をCSV でインポートする API で 対象の CSV をアップロードする目的の API です。
kintone のレコードにファイルを添付する目的でファイルをアップロードする API は、こちらのドキュメントをご参照ください。