Singularity: The New GameWisp API and Integrations
It’s Finally Here!
After taking much too long to finish, the GameWisp API is complete enough to show to the world. It has two components: a conventional REST API (think the Twitch API), and a real-time WebSockets enabled API called Singularity.
In addition to releasing the API, a few brave souls out there decided to integrate GameWisp into their applications before the official release. To thank them for their feedback and hard work, we’ll be showcasing their GameWisp-integrated applications at the end of this post.
So…What is this API Really?
The API is actually two separate components: a conventional REST API and Singularity. The REST API is great if you need to query an endpoint for some information. Singularity is perfect if you’re building an application that requires updated GameWisp information in real time. Singularity is all the fun of up-to- the-minute data without the hassle of polling.
Both the REST API and Singularity authorize access to channel data using a fairly bog-standard implementation of OAuth2. So if you’ve ever had to use the Twitch API for anything, you’re in familiar territory. Access tokens generated for a GameWisp channel can be used for both the REST API and Singularity, so it’s trivial to write an application that leverages both APIs if you want.
Yay! Who Cares?
Why should you use the GameWisp API? It’s really great for solving a few key problems users have mentioned to us:
- I want to automatically fulfill benefits that aren’t fulfilled automatically by GameWisp.
- I want functionality like TwitchAlerts’ StreamLabels, Event List, etc.
- I want to use GameWisp benefits to provide access to extra functionality on my own website.
- I want my bot to have knowledge of my GameWisp subscribers automatically.
Using the API, you can do all this and more. For example, you could write a bot to automatically handle currency benefits from GameWisp. You could use the REST API to determine what benefits a subscriber has, and leverage that information to provide access to certain pages on your own website. You could use Singularity to update a file on your desktop in real-time, and plug that file into TwitchAlerts’ StreamLabels. You could build a giveaway tool, a game server whitelister, a Discord bot with GameWisp integration, or a number of other fantastically awesome things.
Cool, So Who’s Using this API Right now?
As I mentioned earlier, a few brave souls have incorporated GameWisp into their applications already and provided some really crucial feedback to help improve the API. We couldn’t have made it this far without them, so showcasing their integrations seems like a pretty classy thing to do.
Without further adieu, the current integrations:
Status: GameWisp integration is in active development and coming soon!
Deepbot is an alternative solution to the Twitch dashboard while also adding additional features such as Minigames, Points and follower/subscriber alerts via the form of a bot which sits in your channel.
Integration: “The features you’ve come to expect of Deepbot will now be able to be triggered through your Gamewisp subscriptions. Every time someone ‘Subscribes’ to your channel the intergration will allow auto moves to different VIP levels depending on the tier to which they subscribed, an alert will also pop up on screen to show their support to your whole stream (if you choose).”
Status: Open Beta
Forge Sub Whitelist allows you to automatically whitelist GameWisp, Twitch, and Beam subscribers. The whitelist runs as a Minecraft mod so that subscribers don’t have to wait for a list to be updated externally. Its instantaneous!
Integration: Allows channels to setup a mine craft server benefit, and direct new subscribers to their minecraft server. Upon entering the server, the mod checks for a server benefit for minecraft and, if the user has it, allows access to the server.
Status: Muxy’s GameWisp integration will be live soon after 11 AM CDT on 3/16/16!
Muxy offers instantaneous, easily customizable alerts for your Twitch stream. Muxy Analytics, currently in open beta, can help you discover how to best connect with your community.
Integration: Display alerts on your stream when you get GameWisp subscriptions, and include your GameWisp subs on your Analytics page.
Status: Early Open Alpha
A new age has come, and thus requires a new form of bot. Orryx is the foremost streaming companion that suits every need. Developed by streamers, for streamers. Currently in open Alpha whilst we develop.
Integration:
- Keep track of all your subs in one easy location.
- Receive notifications in both your twitch channel,and discord channel when somebody subscribes.
- Further reward your subs, with achievements.
Status: Open Beta
StreamJar is the all-in-one tool for all livestreamers, serving as an overlay builder, alert/notification service, and giveaway manager, with the aim to make every aspect of your livestream customizable in an easy-to-use way.
Integration: Put customizable on-screen notifications for subscriptions into your stream as well as chat notifications!
Status: Coming Soon
Created by the same team behind the SubsOnly project, StreamPerk is a service created for both partners and non-partners. It will allow streamers to easily create private communities for their subscribers, donors and loyal viewers. Informed by their experience with SubsOnly, StreamPerk has been built from the ground up to be more customizable, extendable, and simple, and will receive the same stream of steady updates as its predecessor, every few weeks.
Integration: Automatically give your GameWisp subscribers access to your StreamPerk Site
I Want to Make a Thing, How do I Get Started?
First, you need to make a GameWisp channel. If you don’t have one, do that first by going here. After that, go check out the Getting Started section of the docs and… you know… get started, I guess.
The API is currently read-only, that means you cannot POST to it and update the internal state of a GameWisp channel, benefits, etc. It is likely that this restriction will be lifted in the future, but we want to see how developers use the API before arbitrarily allowing applications to modify state.
That’s it!
There’s no need for more fanfare than that. Go forth, build things. Let us know what cool stuff you build so we can go check it out.
Originally published at blog.gamewisp.com on Mar 16, 2016.
