NAME

Twitter::API::Trait::AppAuth - App-only (OAuth2) Authentication

VERSION

version 1.0005

SYNOPSIS

    use Twitter::API;
    my $client = Twitter::API->new_with_traits(
        traits => [ qw/ApiMethods AppAuth/ ]);

    my $r = $client->oauth2_token;
    # return value is hash ref:
    # { token_type => 'bearer', access_token => 'AA...' }
    my $token = $r->{access_token};

    # you can use the token explicitly with the -token argument:
    my $user = $client->show_user('twitter_api', { -token => $token });

    # or you can set the access_token attribute to use it implicitly
    $client->access_token($token);
    my $user = $client->show_user('twitterapi');

    # to revoke a token
    $client->invalidate_token($token);

    # if you revoke the token stored in the access_token attribute, clear it:
    $client->clear_access_token;

METHODS

oauth2_token

Call the oauth2/token endpoint to get a bearer token. The token is not stored in Twitter::API's state. If you want that, set the access_token attribute with the returned token.

See https://developer.twitter.com/en/docs/basics/authentication/api-reference/token for details.

invalidate_token($token)

Calls the oauth2/invalidate_token endpoint to revoke a token. See https://developer.twitter.com/en/docs/basics/authentication/api-reference/invalidate_token for details.

AUTHOR

Marc Mims <marc@questright.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2018 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.