ホーム API/ツール API データ保管BOX

データ保管BOX

    データ保管BOX APIでは、クラウドストレージエリアとの通信を隠蔽し、データ保管BOX 上のフォルダ / ファイルリストの取得、ファイルのアップロード、ダウンロードといった機能を提供します。

    API
    基本情報
    提供 : REST,SDK(Android™,iOS)
    • 審査 : アプリ審査
    ご利用いただくためには「アカウント登録(無料)」が必要です。

    リファレンスを参照するAPI機能名を選択してください

    アップロード事前投入

    IDおよびパスによって指定されたファイルのアップロード準備を行います。

    リクエストURL

    https://xlb.datastoragebox.smt.docomo.ne.jp/box_a2/4.0/preupload/{path}

    メソッド : POST
    文字コード : UTF-8

    リクエストパスパラメータ

    キー 必須 説明
    {path} アップロードするファイルのパスを指定。
    長さは159文字を上限とする。
    全角、半角に関わらず文字数としてカウントする。
    (データ保管BOXのルートからの絶対パス "/"区切りで記述する)

    リクエストヘッダ

    キー 必須 説明
    Content-Type 送信データのMIMEタイプは、下記を指定。
    application/json
    Authorization OAuth認証スキーム。
    「Bearer + スペース + <access_token>」の形式でアクセストークンを指定する。
    詳細は API共通リファレンス 2.3を参照。

    ※OAuth を利用するためのAndroid™、iOSおよびJava SDKを提供しております。 こちらを参照ください。

    リクエストボディ(JSON形式)

    キー 必須 説明
    owner_ap_cd オーナーAPコードを指定。
    IFを発行したAPを特定する。
    設定値の説明については 仕様書「コード定義」参照。
    id ファイル管理のID。
    新規アップロード時 : 指定しない。
    更新アップロード時 : ファイルIDを指定する。
    size アップロードするファイル全体のサイズを指定。
    revision リビジョン番号(1~2147483647)。
    新規アップロード時 : 指定しない。
    更新アップロード時 : 指定する。
    hash_value 送信コンテンツ全体に対するハッシュ値を指定(ハッシュ関数はMD5)。

    レスポンスヘッダ

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記を返却。
    application/json

    レスポンスボディ(JSON形式)

    キー 必須 説明
    id ファイル管理の一時IDを返却。
    division_no 分割No(1~2147483647)。
    新規アップロード時 : 1を返却。
    再開時 : 処理が終わっていないデータの最小の分割Noを返却。
    division_size 分割サイズを返却。
    細分化したファイルの分割単位。
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。