NAME

WebService::DMM - DMM webservice module

SYNOPSIS

  use WebService::DMM;
  use Config::Pit;

  my $config = pit_get('dmm.co.jp', require => {
      affiliate_id => 'DMM affiliate ID',
      api_id       => 'DMM API ID',
  });

  my $dmm = WebService::DMM->new(
      affiliate_id => $config->{affiliate_id},
      api_id       => $config->{api_id},
  );

  my $response = $dmm->search( %params );
  die "Failed to request" unless $response->is_success;

  for my $item (@{$response->items}) {
      ....
  }

DESCRIPTION

WebService::DMM is DMM webservice module. DMMhttp://www.dmm.com is Japanese shopping site.

INTERFACES

Class Methods

WebService::DMM->new(%args) :WebService::DMM

Create and return a new WebService::DMM instance with %args.

%args must have following parameter:

affiliate_id

Affiliate ID of DMM. Postfix of affliate_id should be 900-999.

api_id

API ID of DMM. Register your account in DMM and you can get API ID.

Instance Method

$dmm->search(%param) : WebService::DMM::Response

%params mandatory parameters are:

operation :Str = "ItemList"

version :Str = "2.00"

Version should be '1.00' or '2.00'.

timestamp :Str = current time

Time format should be 'Year-Month-Day Hour:Minute:Second' (strftime format is '%Y-%m-%d %T')

site :Str

Site, 'DMM.co.jp' or 'DMM.com'.

%param optional parameters are:

hits :Int = 20

Number of items

offset :Int = 1

Offset of searched results

sort :Str = "rank"

Type of sort, 'rank', '+price', '-price', 'date', 'review'.

service :Str

See "SERVICE AND FLOOR" section

floor :Str

See "SERVICE AND FLOOR" section

keyword :Str

Search keyword. You can use DMM search keyword style. Keyword should be string(not byte sequence).

$dmm->last_response : Furl::Response

Return last response which is a Furl::Response instance.

SERVICE AND FLOOR

DMM.com services are:

lod

akb48, ske48

digital

bandai, anime, video, idol, cinema, fight

monthly

toei, animate, shochikugeino, idol, cinepara, dgc, fleague

digital_book

comic, novel, photo, otherbooks

pcsoft

pcgame, pcsoft

mono

dvd, cd, book, game, hobby, kaden, houseware, gourmet

rental

rental_dvd, ppr_dvd, rental_cd, ppr_cd, comic

nandemo

fashion_ladies, fashion_mems, rental_iroiro

DMM.co.jp services are:

digital

videoa, videoc, nikkatsu, anime, photo

monthly

shirouto, nikkatsu, paradisetv, animech, dream, avstation, playgirl, alice, crystal, hmp, waap, momotarobb, moodyz, prestige, jukujo, sod, mania, s1, kmp, mousouzoku

ppm

video, videoc

pcgame

pcgame

doujin

doujin

book

book

mono

dvd, good, anime, pcgame, book, doujin

rental

rental_dvd, ppr_dvd

CUSTOMIZE USER AGENT

You can specify your own instance of Furl to set $WebService::DMM::UserAgent.

    $WebService::DMM::UserAgent = Furl->new( your_own_paramter );

EXAMPLES

There are many examples in the "eg/" directory in this distribution.

AUTHOR

Syohei YOSHIDA <syohex@gmail.com>

COPYRIGHT

Copyright 2013 - Syohei YOSHIDA

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Official Guide https://affiliate.dmm.com/api/guide/

cpanm WebService::DMM

perl -MCPAN -e shell
install WebService::DMM