You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/endpoints/getGJLevels21.md
+13-12Lines changed: 13 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,8 +22,7 @@ Gets a list of levels.
22
22
23
23
**gauntlet** - The ID of the gauntlet that's currently being loaded.
24
24
25
-
**type** - Controls the fetch priority.
26
-
and if this is left out it's most liked
25
+
**type** - Controls the fetch priority. By default it's most liked.
27
26
28
27
| type | desc |
29
28
| ---- | ---- |
@@ -47,19 +46,21 @@ and if this is left out it's most liked
47
46
| 21 | Daily History |
48
47
| 22 | Weekly History |
49
48
50
-
**str** - Search string, required when `type` is 5 or 10
49
+
**str** - Search string, required when `type` is 5 or 10.
51
50
52
-
**diff** - Difficulty filter. A list of integers denoting the different difficulties.
51
+
**diff** - Difficulty filter. A list of integers denoting the different difficulties. Negative difficulties are ignored when any positive one is specified.
53
52
54
53
| diff | desc |
55
54
| ---- | ---- |
56
-
| -1 | N/A (doesn't work) |
57
-
| -2 | Demons (use the **demonFilter** parameter to denote which demon type to search) |
| -2 | Demons (use the `demonFilter` parameter to denote which demon type to search) (exclusive from -3) |
57
+
| -3 | Auto (exclusive from -2) |
58
58
| 1 | Easy |
59
59
| 2 | Normal |
60
60
| 3 | Hard |
61
61
| 4 | Harder |
62
62
| 5 | Insane |
63
+
| 6–10 | Easy to Extreme Demon, respectively |
63
64
64
65
**len** - Length Filter.
65
66
@@ -71,9 +72,11 @@ and if this is left out it's most liked
71
72
| 3 | Long |
72
73
| 4 | XL |
73
74
74
-
**page** - Which page of levels you want to see
75
+
**page** - Which page of levels you want to see.
75
76
76
-
**total** - Current use is unknown, defaults to the amount of levels available, up to 9999, but leaving it out or as 0 works.
77
+
**total** - Current use is unknown, defaults to the amount of levels available, up to 9999. Most likely it's a caching system for avoiding excessive execution of expensive COUNT database queries.
78
+
79
+
**count** - Size of a single page of levels. Capped at 10.
77
80
78
81
**uncompleted** - Uncompleted filter. 0 for off, 1 for on.
79
82
@@ -95,16 +98,14 @@ and if this is left out it's most liked
95
98
96
99
**song** - Official song filter. Not sent when off.
97
100
98
-
**customSong** Enable newgrounds song filter, **song** parameter will be songID, Not sent when off
101
+
**customSong**- Enable newgrounds song filter, **song** parameter will be songID. Not sent when off.
99
102
100
103
**completedLevels** - A comma separated list of completed levels enclosed in brackets. Only sent if the uncompleted or completed filter is enabled.
101
104
102
105
**followed** - Required if `type` is 12. A comma separated list of player IDs, **not account IDs** of the people you follow.
103
106
104
107
**demonFilter** - Denotes which difficulty of demon to search for if `diff` is -2. If left out it will search for all demons, otherwise it's 1-5 for Easy to Extreme, respectively.
105
108
106
-
**secret** - Wmfd2893gb7
107
-
108
109
## Response
109
110
110
111
Returns a list of [level objects](/resources/server/level) separated by pipes `|` and sorted by the parameters, a list of objects denoting the authors sorted by increasing player ID (format is `PLAYERID:USERNAME:ACCOUNTID`) which are also separated by pipes `|`, and a list of [song objects](/resources/server/song) sorted by increasing song ID and separated by `~:~`. The indexers for each are `:`, `:` and `~|~` respectively.
0 commit comments