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

dフォト

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

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

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

    コンテンツ情報取得(原本・リサイズ)

    コンテンツ(原本・リサイズ)の画像データを取得します。

    テクニカルガイドライン

    • リサイズNGフラグ=1(NG)のコンテンツの場合、ダミー画像が返却されます。
    • リサイズ画像のEXIFは、Orientation以外は原本と同じ内容になります。
    • リサイズ画像 ※1 は、原本画像を原本のEXIF-Orientationで補正した向きに回転加工されます。これに伴いリサイズ画像のEXIF-Orientation=1固定となります。
    • dフォトの画面上でユーザが画像を回転させた結果は「IF_XLB_R074 コンテンツIDリスト取得(タグ詳細付)」レスポンスの「回転情報」に反映されます。
      この「回転情報」はリサイズ画像(上記 ※1 )に対する補正角度になります。原本画像の向きを補正するためには、「回転情報」に加えて原本のEXIF-Orientationを反映する必要があります。

    リクエストURL

    https://xlb.photocolle-docomo.com/file_a2/2.0/ext/content/get

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

    リクエストヘッダ

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

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

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

    キー 必須 説明
    file_type_cd 画像種別コードは、下記のいずれかを指定。
    1 : 静止画
    2 : 動画
    3 : アルバム
    content_guid 取得対象画像のファイルID。
    resize_type_cd ファイル種別。
    ・下記のいずれかを指定。
    1 : 原本
    2 : リサイズ画像

    レスポンスヘッダ(処理成功)

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記のいずれかを返却。
    image/jpeg
    image/pjpeg
    image/png
    video/3gpp
    video/avi
    video/quicktime
    video/mp4
    video/vnd.mts
    video/mpeg
    video/x-m4v

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

    キー 必須 説明
    - コンテンツのバイナリデータ。

    レスポンスヘッダ(処理失敗)

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

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

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