NAME

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

VERSION

version 1.0002

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://dev.twitter.com/oauth/reference/post/oauth2/token for details.

invalidate_token($token)

Calls the oauth2/invalidate_token endpoint to revoke a token. See https://dev.twitter.com/oauth/reference/post/oauth2/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.