エンドポイント
GET https://api.dmm.com/affiliate/v3/SeriesSearch
リクエストURL例
https://api.dmm.com/affiliate/v3/SeriesSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&initial=%e3%81%8a&floor_id=27&hits=10&output=json
リクエストパラメータ
api_id必須APIID
登録時に割り振られたID
値の例YOUR_API_ID
使用例
api_id=YOUR_API_IDaffiliate_id必須アフィリエイトID
APIリクエスト専用のアフィリエイトID(末尾990~999)。※商品リンク作成時は通常のアフィリエイトIDをご利用ください
値の例affiliate-990
使用例
affiliate_id=affiliate-990floor_id必須フロアID
フロア検索APIから取得可能なフロアID
値の例27
使用例
floor_id=27initial任意頭文字(50音)
50音をUTF-8で指定
値の例あ
使用例
initial=あhits任意取得件数
初期値:100 最大:500
値の例100
使用例
hits=100offset任意検索開始位置
初期値:1
値の例1
使用例
offset=1output任意出力形式
json / xml
値の例json
使用例
output=jsoncallback任意コールバック
出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます
値の例callback
使用例
callback=callback全パラメータ例
https://api.dmm.com/affiliate/v3/SeriesSearch?
api_id=YOUR_API_ID&
affiliate_id=affiliate-990&
floor_id=27&
initial=あ&
hits=100&
offset=1&
output=json&
callback=callback
パラメータ値は読みやすさのために未エンコードで記載しています。送信時は URL エンコードしてください。
SDK での使用例
const dmm = require('dmm.js');
const client = new dmm.Client({
api_id: "YOUR_API_ID",
affiliate_id: "affiliate-990"
});
client.series(
{
floor_id: 27,
initial: "あ",
hits: 100,
offset: 1,
output: "json",
callback: "callback",
},
(err, data) => {
if (err) {
console.error(err);
return;
}
console.log(data);
}
);
レスポンスフィールド
フィールド
説明
例
リクエストパラメータ
nameパラメータ名
affiliate_id
value値
affiliate-990
statusステータスコード
200
result_count取得件数
100
total_count全体件数
1000
first_position検索開始位置
1
site_nameサイト名
DMM.com(一般)
site_codeサイトコード
DMM.com
service_nameサービス名
通販
service_codeサービスコード
mono
floor_idフロアID
24
floor_nameフロア名
本・コミック
floor_codeフロアコード
book
シリーズ情報
series_idシリーズID
62226
nameシリーズ名
ARIA
rubyシリーズ名(読み仮名)
ありあ
list_urlリストページURL(アフィリエイトID付き)
https://al.dmm.com/...