ATTENTION

THIS MODULE IS UNDER CONSTRUCTION. INTERFACES AND RESPONCES ARE NOT STABLE.

NAME

Net::Nakamap - A Perl interface to the Nakamap API

VERSION

This document describes Net::Nakamap version 0.02.

SYNOPSIS

    use Net::Nakamap;

    my $nakamap = Net::Nakamap->new(
        client_id     => $client_id,
        client_secret => $client_secret,
    );

    # generate uri for authentication
    my $auth_uri = $nakamap->auth_uri();

    # get access token
    my $res   = $nakamap->auth_code({ code => $code });
    my $token = $res->{access_token};

    # GET
    my $me = $nakamap->get('/1/me', { token => $token });

    # POST
    $nakamap->post('/1/me/profile', {
        token => $token,
        name  => 'Alice',
    });

DESCRIPTION

Tiny helper for using Nakamap API.

METHODS

$nakamap = Net::Nakamap->new(%options)

Creates a new Net::Nakamap instance.

%options is a Hash. kesy of %option are:

• client_id

  client id for your app.

• client_secret

  client secret for your app.

• token

  Not required. If given, you can ommit token for each get or post method.

$nakamap->auth_uri($params)

Generate uri for authentication. Returns URI object.

$params is a HashRef. keys of $params are:

• response_type

• scope

$nakamap->auth_code($code)

Authenticate authorization code. Returns hash including token.

$nakamap->get($path, $params)

Send GET request to Nakamap API.

$nakamap->post($path, $params, $files)

Send POST request to Nakamap API.

files in $files are sent as multipart/form-data.

    $files = {
        icon => 'path/to/file',
    }

or

    $files = {
        icon => \$binary_data,
    }

SEE ALSO

• Developer Site for Nakamap.

  http://developer.nakamap.com

• Nakamap API document.

  https://github.com/nakamap/docs/wiki/Api-docs

REPOSITORY

• GitHub

  https://github.com/kayac/p5-Net-Nakamap

AUTHOR

NAGATA Hiroaki <handlename> <handle _at_ cpan _dot_ org>

LICENSE AND COPYRIGHT

Copyright (c) 2013, NAGATA Hiroaki <handlename>. All rights reserved.

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