NAME

WebService::Instapaper - A client for the Instapaper Full API

SYNOPSIS

use WebService::Instapaper;

my $client = WebService::Instapaper->new(consumer_key => '...', consumer_secret => '...');

$client->auth('username', 'password');

# or
$client->token('access_token', 'access_token_secret');

# get bookmark list
my @bookmarks = $client->bookmarks;

# archive bookmarks
my $bookmark = shift @bookmarks;
$client->archive_bookmark($bookmark->{bookmark_id});

DESCRIPTION

WebService::Instapaper is a client for the Instapepr Full API (https://www.instapaper.com/api)

• new(\%options)

  Create new instance of this module. %options should contain following keys: consumer_key and consumer_secret.

• auth($username, $password)

  Authenticate with given $username and $password.

• token($access_token, $access_secret)

  Set existing access token to the instance.

• bookmarks(\%options)

  Return bookmark list. By default, it returns 25 bookmark items.

  %options may contain limit to specify the number of results.

    my @many_bookmarks = $client->bookmarks(limit => 100);
  

• add_bookmark($url, \%options)

  Add new bookmark to Instapaper.

    $client->add_bookmark('http://www.example.org/');
  
    # with details
    $client->add_bookmark('http://www.example.org/', title => 'Example Article', description => 'This is an example.');
  

• delete_bookmark($bookmark_id)

  Delete the bookmark.

• archive_bookmark($bookmark_id)

  Archive the bookmark.

• unarchive_bookmark($bookmark_id)

  Unarchive the bookmark.

LICENSE

Copyright (C) Shun Takebayashi.

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

AUTHOR

Shun Takebayashi shun@takebayashi.asia