ホーム API/ツール API dフォト

dフォト

    dフォトAPIを利用すると、クラウドへ写真・動画をアップロードしたり、クラウドから写真・動画の取得ができます。

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

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

    アップロード

    コンテンツ書き込みAPIを使用して原本データの登録が可能となります。

    テクニカルガイドライン

    • チャンク取得(Rangeリクエスト)は使用できません。

    リクエストURL

    https://xlb.photocolle-docomo.com/file_a2/1.0/docomo/create

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

    リクエストヘッダ

    キー 必須 説明
    Content-Type 送信データのMIMEタイプは、下記を指定。
    multipart/form-data
    Authorization OAuth認証スキーム。
    詳細はAPI共通リファレンス 2.3を参照。

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

    リクエストボディ(multipart/form-data形式)

    キー 必須 説明
    type ファイルタイプ(画像や動画)は、下記のいずれかを指定。
    Image : 画像
    Video : 動画
    title 拡張子を含んだ文字。
    size ファイルのサイズ(byte)を指定。
    ・画像の場合 : 1~30MB
    ・動画の場合 : 1~100MB
    mime_type MIMEタイプを指定。
    ・画像の場合
    image/jpeg : JPEG画像
    image/pjpeg : PJPEG画像
    image/png : PNG画像

    ・動画の場合
    video/3gpp : 3GP動画(.3gp)
    video/avi : AVI動画(.avi)
    video/quicktime : (.mov)
    video/mp4 : (mp4)
    video/vnd.mts : (.mts)
    video/mpeg : (m2ts)
    video/x-m4v : (m4v)
    file 画像・動画データを指定(画像は最大30MBまで、動画は最大100MBまで可能)。
    ※Content-Dispositionのfilenameに拡張子を含んだファイル名が必要。

    レスポンスヘッダ

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

    レスポンスボディ(処理成功)(JSON形式)

    キー 必須 説明
    result 処理結果は、下記を返却。
    0 : 成功
    data_id ファイルIDを返却。
    コンテンツに対してサーバ側で採番された一意の値。
    アップロードされたコンテンツのファイルIDが設定される。

    レスポンスボディ(処理失敗)(JSON形式)

    キー 必須 説明
    result 処理結果は、下記を返却。
    1 : 失敗
    err_list エラーが発生した場合に配列形式で設定される。
    err_cd エラーの詳細内容を表すコード。詳細は 仕様書「業務エラーコード一覧」参照。
    設定値については 仕様書「業務エラーマッピング」参照
    err_item エラーが発生したリクエストの項目名が設定される。
    data_id - 【PCアプリのみ】
    エラーステータスコードが「1101」の場合は、重複したファイルIDを設定する。
    status - 【PCアプリのみ】
    コンテンツの状態が設定される。エラーステータスコードが「1101」の場合、必須となる。
    詳細は仕様書「2.状態に対応する内容」を参照。
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。