/user/information

Get basic information about a user.

📘

user_read Scope Required

This endpoint requires use of the user_read scope. Be sure to request it when you generate access tokens.

This endpoint returns basic user information, including their profile contents and their profile picture. Use this endpoint if you're wanting to implement "Login with GameWisp" style functionality and you want to leverage a GameWisp user's information to generate user accounts and profiles within your own application.

The profile picture object is a nested JSON structure that describes the various resolutions of profile pictures available. The basic structure is as follows:

🚧

Please Respect our Bandwidth

If you're going to make prolific use of images from GameWisp's servers, please download them and store them on your own servers as opposed to linking directly to our assets.

JSON

"full": {
                  "container": "profile-art",
                  "blob": "profile_picture_43_14e2165c-ca35-4fe5-8d34-69e3bc42ca12.png",
                  "type": "png",
                  "size": {
                    "height": 128,
                    "width": 128
                  }
                },

There can be up to seven different resolutions of a profile picture available, including:

• full - source image uploaded to GameWisp by the user
• large - the source image processed to at least 800px wide.
• large_sq - an 800x800px processed image, may be cropped depending on original aspect ratio.
• medium - the source image processed to at least 300px wide.
• medium_sq - an 300x300px processed image, may be cropped depending on original aspect ratio.
• small - the source image processed to at least 100px wide.
• small_sq - a 100x100px processed image, may be cropped depending on the original aspect ratio.

The path to an image stored on GameWisp's servers is:

https://:base_url/:container/:blob

For example, using the above example JSON response the path to the source image of the user's avatar would be:

https://az650423.vo.msecnd.net/profile-art/profile_picture_43_14e2165c-ca35-4fe5-8d34-69e3bc42ca12.png

Include Parameters

📘

This endpoint has a nested include parameter

The user's profile picture is a nested include parameter. To get it, pass in profile.picture for the include parameter

Parameter	Description
profile	Get the basic user profile with the user object.
profile.picture	Get the profile object with a nested picture object that describes the user's profile picture.