REST API リファレンス
- ドキュメントトップ
-
共通
-
プッシュ通知
-
会員管理・認証
-
データストア
-
ファイルストア
-
スクリプト
共通ドキュメント
ファイル登録
Contents |
ファイル登録APIについて
URLに指定したファイル名とリクエストのファイルデータをもとに、ファイルの登録を行います。
なおAPIパスのファイル名にスラッシュ「/」「*」が存在する場合は有効値エラーとなります。
詳細は、開発ガイドライン:ファイルストアについてをご参照ください。
基本仕様
- APIパス:/files/ファイル名
- メソッド:POST
リクエストヘッダー
シグネチャやAPIキーなどの詳細は「共通フォーマット」を参照してください。
フィールド名 | 内容 |
---|---|
Content-Type | multipart/form-data |
リクエストコンテント
パラメータ名 | 説明 | データ型 | 必須 |
---|---|---|---|
file | ファイルデータ | - | ○ |
acl | ACL | 一対一オブジェクト |
ACLは未設定の場合、システムのデフォルト値が初期値となります。
詳細はACLフォーマットをご覧ください。
デフォルト値を設定したくない場合は「{}」を指定してください。
HTTPステータス
ステータスコード | 内容 |
---|---|
201 | ファイル登録完了 |
レスポンスヘッダー
フィールド名 | 内容 |
---|---|
Content-Type | application/json |
Location | https://mbaas.api.nifcloud.com/2013-09-01/files/ファイル名 |
レスポンスコンテント
パラメータ名 | 説明 | データ型 |
---|---|---|
createDate | 登録日時 | 日時 |
fileName | ファイル名 | 文字列 |
リクエストサンプル
curl -X "POST" \
-H "X-NCMB-Application-Key: 0a0b9f31bbbc90d62fa03c9cb9d3b37a5bccca69da829b59e9a4e4c720f2e3dd" \
-H "X-NCMB-Timestamp: 2013-09-03T07%3A03%3A59.456Z" \
-H "X-NCMB-Signature: oRZCfA+LwZE58gvvIHtcfQ57arSb2ViNl9qVKunwo7A=" \
-H "Content-Type: multipart/form-data" \
-F "file=@testfile4" \
-F 'acl={"*":{"write": true, "read":true},"AAA":{"write":true,"read":true}}' \
https://mbaas.api.nifcloud.com/2013-09-01/files/testfile4
レスポンスサンプル
HTTP/1.1 201 Created
Content-Type: application/json
Location: https://mbaas.api.nifcloud.com/2013-09-01/files/testfile4
{"createDate":"2013-09-03T10:24:41.214Z","fileName":"testfile4"}
お探しの内容が見つからなかった場合はユーザーコミュニティ
もご活用ください。(回答保証はいたしかねます)
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。
推奨画面サイズ1024×768px以上