NAME
    URI::Amazon::APA - URI to access Amazon Product Advertising API

VERSION
    $Id: README,v 0.1 2009/05/10 11:04:33 dankogai Exp dankogai $

SYNOPSIS
      # self-explanatory
      use strict;
      use warnings;
      use URI::Amazon::APA;
      use LWP::UserAgent;
      use XML::Simple;
      use YAML::Syck;

      use URI::Amazon::APA; # instead of URI
      my $u = URI::Amazon::APA->new('http://webservices.amazon.com/onca/xml');
      $u->query_form(
        Service     => 'AWSECommerceService',
        Operation   => 'ItemSearch',
        Title       => shift || 'Perl',
        SearchIndex => 'Books',
      );
      $u->sign(
        key    => $public_key,
        secret => $private_key,
      );

      my $ua = LWP::UserAgent->new;
      my $r  = $ua->get($u);
      if ( $r->is_success ) {
        print YAML::Syck::Dump( XMLin( $r->content ) );
      }
      else {
        print $r->status_line, $r->as_string;
      }

EXPORT
    None.

METHODS
    This adds the following methods to URI object

  sign
    Sings the URI accordingly to the Amazon Product Advertising API.

      $u->sign(
        key    => $public_key,
        secret => $private_key,
      );

  signature
    Checks the signature within the URI;

      print "The signature is " : $u->signature;

AUTHOR
    Dan Kogai, "<dankogai at dan.co.jp>"

BUGS
    Please report any bugs or feature requests to "bug-uri-amazon-apa at
    rt.cpan.org", or through the web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=URI-Amazon-APA>. I will
    be notified, and then you'll automatically be notified of progress on
    your bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc URI::Amazon::APA

    You can also look for information at:

    *   RT: CPAN's request tracker

        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=URI-Amazon-APA>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/URI-Amazon-APA>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/URI-Amazon-APA>

    *   Search CPAN

        <http://search.cpan.org/dist/URI-Amazon-APA/>

ACKNOWLEDGEMENTS
    <http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.h
    tml?rest-signature.html>

COPYRIGHT & LICENSE
    Copyright 2009 Dan Kogai, all rights reserved.

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

