NAME

    WWW::StreamAPI - Perl interface for the HTTP StreamAPI API

SYNOPSIS

    use WWW::StreamAPI;

    my $streamapi = WWW::StreamAPI->new(
        secret_key => 'YOUR_SECRET_KEY_HERE',
        api_key => 'YOUR_API_KEY_HERE',
        debug => 1,
    );

    # Fetch a list of live sessions using the simple request method.
    my $live_session_list = $streamapi->request('/session/live/list');
    print Dumper \$live_session_list;

    # Using the live_sessions helper method.
    my @live_sessions = $streamapi->live_sessions;
    print Dumper \@live_sessions;

    # Request a list of all recordings.
    my $recordings = $streamapi->request('/video/list');
    print Dumper \$recordings;

DESCRIPTION

A minimal Perl interface to the HTTP API for StreamAPI. http://streamapi.com

Methods

request

    The first parameter is the HTTP path to call, so '/video/list' becomes http://api.streamapi.com/service/video/list.

    The second parameter is a hashref of arguments to send along with the required parametes (rid, sig, api key).

    The third parameter sets the HTTP request method. The default method is GET.

    Examples:

    my $request= $streamapi->request('/video/list');

    my $request = $stickam->request('/path/to/call', { arg1 => 'val1' });

    my $request = $stickam->request('/path/to/call', { arg1 => 'val1' }, 'POST');

    The return value is always the datastructure returned by XML::Simple::XMLin.

live_sessions

    my @live_sesions = $streamapi->live_sessions;

create_session

    my ($private_hostid, $public_hostid) = $streamapi->create_session;

or

    my ($private_hostid, $public_hostid) = $streamapi->create_session( username => 'Peter' );

COPYRIGHT

Copyright 2008, 2009 by Stickam.com <support@stickam.com>

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

See http://www.perl.com/perl/misc/Artistic.html

AUTHOR

Jake Gold <jake@stickam.com>

SEE ALSO

http://streamapi.com