GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Net::Twitter::WrappedResult(3) User Contributed Perl Documentation Net::Twitter::WrappedResult(3)

Net::Twitter::WrappedResult - Wrap an HTTP response and Twitter result

version 4.01043

    use Net::Twitter;

    my $nt = Net::Twitter->new(
        traits => [ qw/API::RESTv1_1 WrapResult/ ],
        %other_new_options,
    );

    my $r = $nt->verify_credentials;

    my $http_response        = $r->http_response;
    my $twitter_result       = $r->result;
    my $rate_limit_remaining = $r->rate_limit_remaining;

Often, the result of a Twitter API call, inflated from the JSON body of the HTTP response does not contain all the information you need. Twitter includes meta data, such as rate limiting information, in HTTP response headers. This object wraps both the inflated Twitter result and the HTTP response giving the caller full access to all the meta data. It also provides accessors for the rate limit information.

new(result => $twitter_result, http_response => $http_response)
Constructs an object wrapping the Twitter result and HTTP response.
result
Returns the Twitter API result, i.e., the decode JSON response body.
http_response
Returns the HTTP::Response object for the API call.
rate_limit
Returns the rate limit, per 15 minute window, for the API endpoint called. Returns undef if no suitable rate limit header is available.
rate_limit_remaining
Returns the calls remaining in the current 15 minute window for the API endpoint called. Returns undef if no suitable header is available.
rate_limit_reset
Returns the Unix epoch time time of the next 15 minute window, i.e., when the rate limit will be reset, for the API endpoint called. Returns undef if no suitable header is available.

Marc Mims <marc@questright.com>

Copyright (c) 2016 Marc Mims

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

2018-01-17 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.