エンドポイント

GET https://api.dmm.com/affiliate/v3/AuthorSearch

リクエストURL例

https://api.dmm.com/affiliate/v3/AuthorSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&iniital=%e3%81%86&floor_id=27&hits=10&output=json

リクエストパラメータ

論理名物理名必須値のサンプル使用例概要
APIIDapi_id必須YOUR_API_IDapi_id=YOUR_API_ID登録時に割り振られたID
アフィリエイトIDaffiliate_id必須affiliate-990affiliate_id=affiliate-990APIリクエスト専用のアフィリエイトID（末尾990～999）。※商品リンク作成時は通常のアフィリエイトIDをご利用ください
フロアIDfloor_id必須27floor_id=27フロア検索APIから取得可能なフロアID
読み仮名initial任意う゛ぃくとるinitial=う゛ぃくとる作者名(読み仮名)をUTF-8で指定、前方一致検索します。
取得件数hits任意100hits=100初期値：100 最大：500
検索開始位置offset任意1offset=1初期値：1
出力形式output任意jsonoutput=jsonjson / xml
コールバックcallback任意callbackcallback=callback出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます

全パラメータ例

https://api.dmm.com/affiliate/v3/AuthorSearch?
  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.author(
  {
    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
作者情報
author_id
作者ID
21414
name
作者名
ヴィクトル・ユゴー
ruby
作者名(読み仮名)
う゛ぃくとるゆごー
another_name
作者別名
ヴィクトル・ユーゴー/ヴィクトル=ユーゴー
list_url
リストページURL（アフィリエイトID付き）
https://al.dmm.com/...