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

dフォト

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

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

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

    アップロード(タグ付き)

    コンテンツ(原本)を登録します。
    コンテンツ登録と同時にアルバムタグの割当を行うことができます。
    ただし、アルバムタグが1ユーザの上限に達している場合は、アルバムタグは付与されません。

    リクエストURL

    https://xlb.photocolle-docomo.com/file_a2/4.0/content/create

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

    リクエストヘッダ

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

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

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

    キー 必須 説明
    file_type_cd 画像種別コードは、下記のいずれかを指定。
    1 : 画像
    2 : 動画
    file_name アップロードを行うコンテンツのファイル名を指定(URLエンコードした文字列)。
    file_data_size アップロードを行うコンテンツのファイルサイズを指定。
    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)
    optional_tag_name - アップロードを行うコンテンツに対し、アルバムタグを付与する場合に、アルバムタグ名を指定(URLエンコードした文字列)。
    file アップロードを行うファイルを指定。
    ※Content-Dispositionのfilenameに拡張子を含んだファイル名が必要。

    レスポンスヘッダ

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

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

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

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

    キー 必須 説明
    result 処理結果は、下記を返却。
    1 : 失敗
    err_cd エラーの詳細内容を表すコード。詳細は 仕様書「業務エラーコード一覧」参照。
    設定値については 仕様書「業務エラーマッピング」参照。
    param_name - エラー発生箇所をリクエスト項目で特定できる場合に、その物理項目名がセットされる。
    param_value - エラー発生箇所をリクエスト項目で特定できる場合に、エラーの発 生した「エラー項目」の値がセットされる。
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。