Users

Overview

Returns a general overview of information about a user.

Method	GET
Endpoint	/user/userID

Output Body (Success)

{
    "version":1,
    "status":200,
    "data":{
        "id":4,
        "username":"thatanimeweirdo",
        "isVerified":true,
        "isPatreon":null,
        "avatar":"https:\/\/spinsha.re\/uploads\/avatar\/5ef8cddb50106.png",
        "songs":0,
		"reviews":0,
		"spinplays":0,
		"cards":[
			{
				"id":1,
				"icon":"http:\/\/spinsha.re\/uploads\/card\/card_b4bcc0b27340a10b012a1ba8a6fd04b0.png",
				"title":"SSSO Spring 2020 Player",
				"description":"This card was given out to every player of the Spring 2020 SpinShare Speen Open tournament."
			},
			...
		],
		"pronouns": "they/them"
    }
}

Output Body (Not Found)

{
    "version":1,
    "status":404,
    "data":[]
}

Charts

Returns all public charts of a user.

Method	GET
Endpoint	/user/userID/charts

Output Body (Success)

{
    "version":1,
    "status":200,
    "data":{[
		{
			"id":1018,
			"title":"Keyboard Combos",
			"subtitle":"",
			"artist":"Discord",
			"charter":"taw.moe",
			"uploader":4,
			"fileReference": "spinshare_645bd72488592",
			"hasEasyDifficulty":false,
			"hasNormalDifficulty":false,
			"hasHardDifficulty":true,
			"hasExtremeDifficulty":false,
			"hasXDDifficulty":true,
			"easyDifficulty": null,
			"normalDifficulty": null,
			"hardDifficulty": null,
			"expertDifficulty": null,
			"XDDifficulty": 70,
			"updateDate": null,
			"updateHash": "0db32e659973a083ef0affa9a4a4eb1e",
			"cover":"https:\/\/spinsha.re\/uploads\/thumbnail\/spinshare_5f2c729b8ea3b.jpg",
			"zip":"https:\/\/spinsha.re\/api\/song\/1018\/download"
		},
		...
	]}
}

Output Body (Not Found)

{
    "version":1,
    "status":404,
    "data":[]
}

Playlists

Returns all playlists of a user.

Method	GET
Endpoint	/user/userID/playlists

Output Body (Success)

{
	"version": 1,
	"status": 200,
	"data": [
		{
			"id": 7,
			"title": "Great Normal\/Hard charts!",
			"description": "Here are some chart's I enjoyed playing on normal\/hard!",
			"fileReference": "playlist_5fc2a88d3c227",
			"user": {
				"id": 4,
				"username": "thatanimeweirdo",
				"isVerified": true,
				"isPatreon": null,
				"pronouns": "she\/they",
				"avatar": "https:\/\/spinsha.re\/uploads\/avatar\/608f35bb4afe4.png"
			},
			"songs": 50,
			"isOfficial": false,
			"cover": "https:\/\/spinsha.re\/uploads\/cover\/playlist_5fc2a88d3c227.png"
		}
	]
}

Output Body (Not Found)

{
    "version":1,
    "status":404,
    "data":[]
}

Reviews

Returns all reviews of a user.

Method	GET
Endpoint	/user/userID/reviews

Output Body (Success)

	{
		"version":1,
		"status":200,
		"data":[
		   {
			  "id":2,
			  "song":{
				 "id":138,
				 "title":"Tendril",
				 "subtitle":"",
				 "artist":"Collin McLoughlin \u0026 Au5",
				 "charter":"Halflite",
				 "uploader":1,
				 "fileReference":"spinshare_5ea59e04df800",
				 "tags":[
					"test",
					"awesome",
					"nice"
				 ],
				 "views":534,
				 "downloads":2,
				 "isExplicit":false,
				 "isTournament":false,
				 "hasEasyDifficulty":false,
				 "hasNormalDifficulty":false,
				 "hasHardDifficulty":false,
				 "hasExtremeDifficulty":false,
				 "hasXDDifficulty":true,
				 "uploadDate":{
					"date":"2020-04-26 16:43:16.000000",
					"timezone_type":3,
					"timezone":"Europe\/Berlin"
				 },
				 "description":"I\u0027m very proud of this chart!"
			  },
			  "user":{
				 "id":2,
				 "username":"not-taw",
				 "coverReference":"",
				 "isVerified":false,
				 "isPatreon":null,
				 "pronouns": "they/them"
			  },
			  "recommended":false,
			  "comment":"Sucks Ass!",
			  "reviewDate":{
				 "date":"2020-05-12 12:55:41.000000",
				 "timezone_type":3,
				 "timezone":"Europe\/Berlin"
			  }
		   },
		   ...
		]
	 }

Output Body (Not Found)

{
    "version":1,
    "status":404,
    "data":[]
}

SpinPlays

Returns all SpinPlays of a user.

Method	GET
Endpoint	/user/userID/spinplays

Output Body (Success)

{
    "version":1,
    "status":200,
    "data":{[
		{
			"id":13,
			"user":{
				"id":1,
				"username":"taw",
				"coverReference":"5f4147b117c7b.png",
				"isVerified":true,
				"isPatreon":true,
				"pronouns": "they/them"
			},
			"videoUrl":"https:\/\/youtu.be\/tPycD9OwojQ",
			"videoThumbnail":"https:\/\/i.ytimg.com\/vi\/tPycD9OwojQ\/maxresdefault.jpg",
			"submitDate":{
				"date":"2020-07-20 18:48:49.000000",
				"timezone_type":3,
				"timezone":"Europe\/Berlin"
			},
			"isActive":true
		},
		...
	]}
}

Output Body (Not Found)

{
    "version":1,
    "status":404,
    "data":[]
}