Misc. Readme changes (Mainly API documentation)

This commit is contained in:
Dylan 2023-07-16 02:19:37 +01:00
parent 2eb4cfef34
commit 07026f9944

View File

@ -8,17 +8,32 @@ fxtwitter exposed all recently processed tweets publicly via a "latest" and "top
Even though Tweets are public, it was a personal concern for me that a tweet with potentially sensitive information in it could suddenly be shown to however many people were browsing the latest tweets page, and could be used as a tool for harassment. This was removed in [The following commit](https://github.com/dylanpdx/BetterTwitFix/commit/87ba86ba502e73ddb370bd4e5b964548d3272400#diff-a11c36d9b2d53672d6b3d781dca5bef9129159947de66bc3ffaec5fab389d80cL115) Even though Tweets are public, it was a personal concern for me that a tweet with potentially sensitive information in it could suddenly be shown to however many people were browsing the latest tweets page, and could be used as a tool for harassment. This was removed in [The following commit](https://github.com/dylanpdx/BetterTwitFix/commit/87ba86ba502e73ddb370bd4e5b964548d3272400#diff-a11c36d9b2d53672d6b3d781dca5bef9129159947de66bc3ffaec5fab389d80cL115)
Additionally, vxTwitter has a 'none' cache option, which is intended to be used behind a service like CloudFlare. vxtwitter.com currently runs with this option enabled to protect user privacy. Additionally, vxTwitter has a 'none' cache option, which is intended to be used behind a service like CloudFlare. vxtwitter.com currently runs with this option enabled to protect user privacy.
## How to use (discord side) ## How to use the hosted version
just put the url to the server, and directly after, the full URL to the tweet you want to embed Just replace twitter.com with vxtwitter.com on the link to the tweet! `https://twitter.com/jack/status/20` -> `https://vxtwitter.com/jack/status/20`
**I now have a copy of this running on a Linode server, you can use it via the following url**
## API
If you're a nerd like me and want to use information about a tweet in your code, you can make a request to `api.vxtwitter.com` to get basic information about a tweet:
`https://api.vxtwitter.com/Twitter/status/1263145271946551300`
```json
{
"date": "Wed May 20 16:31:15 +0000 2020",
"date_epoch": 1589992275,
"hashtags": [],
"likes": 60038,
"mediaURLs": [
"https://video.twimg.com/amplify_video/1263145212760805376/vid/1280x720/9jous8HM0_duxL0w.mp4?tag=13"
],
"replies": 11720,
"retweets": 16729,
"text": "Testing, testing...\n\nA new way to have a convo with exactly who you want. Were starting with a small % globally, so keep your 👀 out to see it in action. https://t.co/pV53mvjAVT",
"tweetID": "1263145271946551300",
"tweetURL": "https://twitter.com/Twitter/status/1263145271946551300",
"user_name": "Twitter",
"user_screen_name": "Twitter"
}
``` ```
https://vxtwitter.com/[twitter video url] or [last half of twitter url] (everything past twitter.com/) #
```
You can also simply type out 'vx' directly before 'twitter.com' in any valid twitter video url, and that will convert it into a working vxTwitter url, for example:
**Note**: If you enjoy this service, please considering donating via [Ko-Fi](https://ko-fi.com/dylanpdx) to help cover server costs **Note**: If you enjoy this service, please considering donating via [Ko-Fi](https://ko-fi.com/dylanpdx) to help cover server costs