NAME

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

VERSION

       version 1.0006

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-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.