【DMM Web API】商品情報を取得し出力するPHPのサンプルコード

DMM API PHPサンプルコード

サンプルでは最低限必要なリクエストパラメータ(抽出条件)を指定し、20件のFANZAの動画作品の情報を取得して表示します。
※コード自体は全てのリクエストパラメータを指定できる様にしています

リクエストパラメータや取得データについてなど、コードの内容は後ほど詳しく説明しますので、コード上のコメントは少なめです。

以下がサンプルコードになります。

<?php
// リクエストパラメータ
$request_param = array(
// 必須項目
'api_id'        => '自分のAPI ID',
'affiliate_id'  => '自分のアフィリエイトID(末尾990-999)',
'site'          => 'FANZA',
// オプション項目
'service'       => 'digital',
'floor'         => '',
'hits'          => '',
'offset'        => '',
'sort'          => '',
'keyword'       => '',
'cid'           => '',
'article'       => '',
'article_id'    => '',
'gte_date'      => '',
'lte_date'      => '',
'mono_stock'    => '',
'output'        => 'xml',
'callback'      =>'',
);
// 「商品情報API」の基本リクエストURL
$url = "https://api.dmm.com/affiliate/v3/ItemList?";
// リクエストURL生成
$first_flag = 1; //ループ初回判定フラグ
foreach($request_param as $key => $value) {
if($first_flag) {
$url .= "{$key}={$value}";
$first_flag = 0;
} else {
$url .= "&{$key}={$value}";
}
}
// 商品データのXMLを取得しオブジェクトに変換
$xml = simplexml_load_file( $url );
// 取得した商品データを$result_dataに格納
$result_data = $xml->result->items->item;
// データを取扱易くする為に$item_listに格納
foreach( $result_data as $item ){
$item_list = array(
'content_id'        => $item->content_id, // 商品のコンテンツID
'title'             => $item->title, // 商品タイトル
'affiliateURL'      => $item->affiliateURL, // アフィリエイトリンク
'imageURL_list'     => $item->imageURL->list, // 商品画像 リスト用
'imageURL_small'    => $item->imageURL->small, // 商品画像 サイズ小
'imageURL_large'    => $item->imageURL->large, // 商品画像 サイズ大
);
// HTML生成
$post_html = <<< EOM
<div style="float:left;margin:5px;height:320px;width:20em;font-size:50%">
<a href="{$item_list['affiliateURL']}"><img src="{$item_list['imageURL_small']}" target="_blank" rel="noopener" alt="{$item_list['title']}"><br>{$item_list['content_id']}<br>{$item_list['title']}</a>
</div>
EOM;
// HTML出力
echo $post_html."\n";
}
?>

サンプルの使い方

サンプルコードの「api_id」と「affiliate_id」を自分のIDに書き換えて実行すると、HTMLタグが出力されます。

• 本サンプルは商品情報をxmlで取得する事が前提なので、「output」は必ず「xml」にしてください
• また、サンプルはFANZAの商品情報を取得しますのでご注意下さい（18禁）

サンプルの出力結果

出力されたHTMLをブラウザで確認するとこの様なFANZAの商品一覧ページが表示されます。（モザイクでわかりにくくてすみません）

情報としては以下を出力しています。

• 商品画像
  • 商品パッケージ画像のSサイズのURLを取得しimgタグのsrcに入れているます。画像は他にSサイズより小さい一覧サイズと最も大きいLサイズが取得可能
• 商品ID
  • DMM（ FANZA）側で独自に設定している商品IDを取得し表示しています。aタグにアフィリエイトURLを設定しています
• 商品タイトル
  • 商品タイトルを取得し表示しています。aタグにアフィリエイトURLを設定しています

今回のサンプルで出力しているHTMLは力技で商品一覧ページの様な外観にしているので、かなり汚くてすみません。。

コードの説明

// リクエストパラメータ
$request_param = array(
// 必須項目
'api_id'        => '自分のAPI ID',
'affiliate_id'  => '自分のアフィリエイトID(末尾990-999)',
'site'          => 'FANZA',
// オプション項目
'service'       => 'digital',
'floor'         => '',
'hits'          => '',
'offset'        => '25',
'sort'          => '',
'keyword'       => '',
'cid'           => '',
'article'       => '',
'article_id'    => '',
'gte_date'      => '',
'lte_date'      => '',
'mono_stock'    => '',
'output'        => 'xml',
'callback'      =>'',
);

// 「商品情報API」の基本リクエストURL
$url = "https://api.dmm.com/affiliate/v3/ItemList?";
// リクエストURL生成
$first_flag = 1; //ループ初回判定フラグ
foreach($request_param as $key => $value) {
if($first_flag) {
$url = $url."{$key}={$value}";
$first_flag = 0;
} else {
$url = $url."&{$key}={$value}";
}
}

// 商品データのXMLを取得しオブジェクトに変換
$xml = simplexml_load_file( $url );
// 取得した商品データを$result_dataに格納
$result_data = $xml->result->items->item;
// データを取扱易くする為に$item_listに格納
foreach( $result_data as $item ){
$item_list = array(
'content_id'        => $item->content_id, // 商品のコンテンツID
'title'             => $item->title, // 商品タイトル
'affiliateURL'      => $item->affiliateURL, // アフィリエイトリンク
'imageURL_list'     => $item->imageURL->list, // 商品画像 リスト用
'imageURL_small'    => $item->imageURL->small, // 商品画像 サイズ小
'imageURL_large'    => $item->imageURL->large, // 商品画像 サイズ大
);

    // HTML生成
$post_html = <<< EOM
<div style="float:left;margin:5px;height:320px;width:20em;font-size:50%">
<a href="{$item_list['affiliateURL']}"><img src="{$item_list['imageURL_small']}" target="_blank" rel="noopener" alt="{$item_list['title']}"><br>{$item_list['content_id']}<br>{$item_list['title']}</a>
</div>
EOM;
// HTML出力
echo $post_html."\n";

    // HTML生成
$post_html .= <<< EOM  //←「.=」にして$post_htmlに追記する形に変更
<div style="float:left;margin:5px;height:320px;width:20em;font-size:50%">
<a href="{$item_list['affiliateURL']}"><img src="{$item_list['imageURL_small']}" target="_blank" rel="noopener" alt="{$item_list['title']}"><br>{$item_list['content_id']}<br>{$item_list['title']}</a>
</div>
EOM;
}
// HTML出力（ループの外に出す）
echo "<h1>商品一覧</h1>\n";  //←商品情報の前にタイトルを追記
echo $post_html."\n";
?>

サンプルを本番環境に組み込む場合

サンプルコードで動的サイトを作ったりWordpressに組み込んだりする場合、以下にご注意下さい

• 今回は簡単なサンプルなのでエスケープ処理を何も入れていませんが、動的ページを作ったりWordpressに組み込むなど環境に合わせたエスケープ処理が必要になります
• 動的にページを生成する様なサイトを作る場合は、APIへ過度なリクエストを防ぐ為にも、取得したデータをキャッシュする様な設計をお願い致します

まとめ

今回初めてDMM APIを利用しましたが、結構作り込まれていて比較的簡単に取り扱う事ができたので、サンプルコードもめちゃくちゃ簡単なもので済みました。

ただ、データによってはオブジェクトリストだったりする為、そのあたりを網羅しようと思うともっと複雑なコードになってきます。

今回も本当はサンプル画像の取得と出力についても取り扱おうと思ったのですが、サンプル画像のURLはオブジェクトリストなのでそれ用の処理が必要で記事ボリュームが増えてしまうので省きました。

という事もあり、DMM APIの記事は今回のサンプルコードを元にどんどん機能を追加していく連載モノにします。

今回出力したHTMLは商品一覧ページ的なものでしたが、次回はサンプル画像とサンプル動画を取得して各々の商品詳細ページを作成しようと思います。