NAME

Net::Moip::V2::Endpoint - Send HTTP requests to an endpoint.

SYNOPSIS

use Net::Moip::V2;

my $moip = Net::Moip::V2->new( ... );

# List orders: GET /orders
my $ep_orders = $moip->endpoint('orders');
my $response = $ep_orders->get;   # $response is a Furl::Response object

DESCRIPTION

This class represents a single endpoint in the Moip API v2. It provides methods for sending raw http requests, handling the authorization and other required http headers for you.

METHDOS

get[$id])

Sends a GET request to the endpoint url. Can optionally append the a resource id to the url. Returns the raw Furl::Response object.

# GET https://api.moip.com.br/v2/orders
my $response = $moip->endpoint('orders')->get;

if ($response->is_success) {
    my $data = $moip->decode_json($response->content);
    foreach my $order (@{ $data->{orders} }) {
        ...
    }
}

# GET https://api.moip.com.br/v2/orders/ORD-123456789012
my $response = $moip->endpoint('orders')->get('ORD-123456789012');

if ($response->is_success) {
    my $order = $moip->decode_json($response->content);
    ...
}

For detailed information about the response format, see https://dev.moip.com.br/v2.0/reference#intro.

post(\%data)

Sends a GET request to the endpoint url. The \%data hashref is encoded to JSON and the proper content type and authentication headers are set. Returns the raw Furl::Response object.

# POST https://api.moip.com.br/v2/orders
my $response = $moip->endpoint('orders')->post({
    ownId: '12345',
    amount: { ... },
    ...
});

if ($response->is_success) {
    my $new_order = $moip->decode_json($response->content);
    ...
}

Consult the official API reference for detailed information about the required data for each endpoint.

decode_json($json_string)

Helper method for decoding json string into perl data.

LICENSE

Copyright (C) Carlos Fernando Avila Gratz.

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

AUTHOR

Carlos Fernando Avila Gratz <cafe@kreato.com.br>