Today we’re launching assist for OAuth Applications. It will enable builders let gamers log in with their itch.io account within a recreation or program. OAuth gives a circulate in your program to securely get an API key that represents one other consumer on itch.io after they approve your utility. You could make API calls on behalf of somebody utilizing your recreation or utility. You can study extra concerning the itch.io API right here.

If you are able to dive in, learn the OAuth documentation, in any other case proceed on for a short abstract.

Creating an utility

To begin utilizing OAuth as a developer you will must register an utility. After filling out a number of easy questions on what you are constructing, your utility is authorized mechanically. 

Head over to User Settings -> OAuth purposes to create your first utility.

As of right this moment, our OAuth implementation solely helps the Implicit Flow, for those who want further assist then please attain out to us.

Authorizing an utility

After creating your utility, it is so simple as sending any customers to your particular itch.io login URL. You can view this URL out of your utility’s web page in your settings web page. Someone logging can evaluate the permissions which might be being requests, and approve it to proceed. The browser is redirected again to your utility the place you possibly can entry the brand new API key.

Using the API key

After the authorization step is full you will have a scoped API key that can be utilized to speak with the itch.io server-side API. The most helpful API name you may make is to get details about the present consumer. You can use this to synchronize a consumer with your individual backend.

Updates to server-side API

As a part of this replace we have up to date the server-side API documentation with extra details about the completely different API keys, together with a brand new endpoint. Over the approaching months we’ll be releasing extra API endpoints. If there’s one thing particular you are searching for depart us a remark or ship us an electronic mail.

Enjoy