NAME

Twitter::API::Trait::RateLimiting - Automatically sleep as needed to handle rate limiting

VERSION

version 1.0006

SYNOPSIS

    use Twitter::API;
    my $client = Twitter::API->new_with_options(
        traits => [ qw/ApiMethods RateLimiting/ ],
        %other_options,
    );
    # Use $client as normal

DESCRIPTION

Twitter's API implements rate limiting in a 15-minute window, and will serve up an HTTP 429 error if the rate limit is exceeded for a window. Applying this trait will give Twitter::API the ability to automatically sleep as much as is needed and then retry a request instead of simply throwing an exception.

ATTRIBUTES

    sub { sleep shift }

SEE ALSO

<https://developer.twitter.com/en/docs/basics/rate-limiting>

AUTHOR

Marc Mims <marc@questright.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2021 by Marc Mims.

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