Net::Safari - Wrapper for Safari Online Books API


Net-Safari documentation  | view source Contained in the Net-Safari distribution.

Index


NAME

Top

Net::Safari - Wrapper for Safari Online Books API

SYNOPSIS

Top

  use Net::Safari

  my $ua = Net::Safari->new(token => 'YOUR_SAFARI_TOKEN');

  my $response = $ua->search();

  if($response->is_success()) {
      print $response->as_string();
  }
  else {
      print "Error:" . $response->message();
  }




DESCRIPTION

Top

You can read more about Safari webservices here: http://safari.oreilly.com/affiliates/?p=web_services

METHODS

Top

new()

  $agent = Net::Safari->new( token => 'MY_SAFARI_TOKEN' );

Construct a Safari object. Token seems optional.

SEARCH

Top

BOOKTITLE

  $res = $ua->search( BOOKTITLE => 'samba' );

  Search book titles. This is currently broken in Safari. 
  See: http://safari.oreilly.com/xmlapi/?search=BOOKTITLE%20LIKE%20XML

TITLE

  $res = $ua->search( TITLE => 'samba' );

  Searches section titles. Will sometimes return book titles if it can't find
  any sections. I consider this a bug.

ISBN

  $res = $ua->search( ISBN  => '059600415X' );

  ISBN must be a complete ISBN, partial ISBN searches don't work.

CODE

  $res = $ua->search( CODE => 'Test::More' );

  Search within code fragments. This is usually a lot more than programlistings. Code snippets that appear within a sentence are usually semanticly tagged as code. So you're just as likely to get text as you are to get program listings with this search.

NOTE

  $res = $ua->search( NOTE => "web services" );

  The documentation says, "Finds matches within Tips and How-Tos." However the results seem to indicate hits in the content. 

CATEGORY

  $res = $ua->search( CATEGORY => "itbooks.security" );

  Search within a category. The list of categories is here:
  http://safari.oreilly.com/affiliates/portals/safari/2004-07-30_Safari_Books_Category_Metadata_Abbreviations.doc

AUTHOR

  $res = $ua->search( AUTHOR => 'Wall' );
  $res = $ua->search( AUTHOR => 'Wall, Larry' );
  $res = $ua->search( AUTHOR => 'Larry Wall' );

  Search by author.

PUBLDATE

  $res = $ua->search( PUBLDATE => '> 20041001' );
  $res = $ua->search( PUBLDATE => '< 20030101' );

  Search before or after a given publish date. The comparison operator, > or < is required.

PUBLISHER

  $res = $ua->search( PUBLISHER => "O'Reilly" );

  Search by publisher.

SUPPORT

Top

AUTHOR

Top

  Tony Stubblebine
  cpan@tonystubblebine.com




COPYRIGHT

Top

SEE ALSO

Top


Net-Safari documentation  | view source Contained in the Net-Safari distribution.