NAME

WebService::Hatena::Fotolife - A Perl interface to the Hatena::Fotolife Atom API

SYNOPSIS

  use WebService::Hatena::Fotolife;

  my $fotolife = WebService::Hatena::Fotolife->new;
     $fotolife->username($username);
     $fotolife->password($password);

  # create a new entry with image filename
  my $EditURI = $fotolife->createEntry(
      title    => $title,
      filename => $filename,
      folder   => $folder,
  );

  # or specify the image source as a scalarref
  my $EditURI = $fotolife->createEntry(
      title     => $title,
      scalarref => \$image_content,
      folder    => $folder,
  );

  # update the entry
  $fotolife->updateEntry($EditURI, title => $title);

  # delete the entry
  $fotolife->updateEntry($EditURI);

  # retrieve the feed
  my $feed = $fotolife->getFeed;
  my @entries = $feed->entries;
  ...

DESCRIPTION

WebService::Hatena::Fotolife provides an interface to the Hatena::Fotolife Atom API.

This module is a subclass of XML::Atom::Client, so see also the documentation of the base class for more usage.

METHODS

new

  my $fotolife = WebService::Hatena::Fotolife->new;
Creates and returns a WebService::Hatena::Fotolife object.

createEntry ( %param )

  # passing an image by filename
  my $EditURI = $fotolife->createEntry(
      title    => $title,
      filename => $filename,
  );

  # or...

  # a scalar ref to the image content
  my $EditURI = $fotolife->createEntry(
      title     => $title,
      scalarref => $scalarref,
  );
Uploads given image to Hatena::Fotolife. Pass in the image source as a filename or a scalarref to the image content. There're some more options described below:

title
Title of the image.

filename
Local filename of the image.

scalarref
Scalar reference to the image content itself.

folder
Place, called "folder" in Hatena::Fotolife, you want to upload your image.

generator
Specifies generator string. Hatena::Fotolife can handle your request along with it. If not passed, the package name of this modules is used.

updateEntry ( $EditURI, %param )

  my $EditURI = $fotolife->updateEntry(
      $EditURI,
      title => $title,
  );
Updates the title of the entry at $EditURI with given options. Hatena::Fotolife Atom API currently doesn't support to update the image content directly via Atom API.