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/