rss-bridge/docs/10_Bridge_Specific/TwitterV2.md
quickwick 780581939a
[TwitterV2Bridge] New Bridge for Twitter v2 API (#2471)
* New Bridge for Twitter using v2 API

* Top comment block, tweaks to match contributing guide

* [TwitterV2Bridge] new Bridge (sort of)

* Discovered the point of, and re-added, no image scaling option

* Fix the phpcs sniff violations (I hope)

* More linter fixes, I figured out how to use phpcs locally

* Removed unnecessary custom version of getContents function

* Limit query to 100 tweets, valid example query, improved error handling

* Added config doc (correctly, I hope) with link from DESCRIPTION

* little tweak to doc
2022-04-04 21:13:05 +02:00

1.3 KiB

TwitterV2Bridge

To automatically retrieve Tweets containing potentially sensitive/age-restricted content, you'll need to acquire your own unique API Bearer token, which will be used by this Bridge to query Twitter's API v2.

Configuration

  1. Make a Twitter Developer account

    • Developer Portal: https://dev.twitter.com

    • I will not detail exactly how to do this, as the specific process will likely change over time. You should easily be able to find guides using your search engine of choice.

    • A basic free developer account grants Essential access to the Twitter API v2, which should be sufficient for this bridge.

  2. Create a Twitter Project and App, get Bearer Token

    • Once you have an active Twitter Developer account, sign in to the dev portal

    • Create a new Project (name doesn't matter)

    • Create an App within the Project (again, name doesn't matter)

    • Go to the Keys and tokens tab

    • Generate a Bearer Token (you don't want the API Key and Secret, or the Access Token and Secret)

  3. Configure RSS-Bridge

    • In config.ini.php (in rss-bridge root directory) add following lines at the end:
    [TwitterV2Bridge]
    twitterv2apitoken = %Bearer Token from step 2%
    
    • If you don't have a config.ini.php, create one by making a copy of config.default.ini.php