Skip to content

Commit

Permalink
Update api.md
Browse files Browse the repository at this point in the history
  • Loading branch information
IgnisRBX authored Oct 29, 2024
1 parent 26af989 commit 60288df
Showing 1 changed file with 21 additions and 107 deletions.
128 changes: 21 additions & 107 deletions content/en-us/projects/assets/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,19 +18,17 @@ You can query items from the Creator Store catalog using the following URL:

You can replace `[categoryId]` and `[params]` with the appropriate [query parameters](#query-parameters) to customize your search.

### CategoryId

Valid categoryIds are:

Audio = 3
Model = 10
Decal = 13
Animation = 24
Plugin = 38
MeshPart = 40
Video = 62
FontFamily = 73
Music = 300
Valid category IDs are:

- Audio = `3`
- Model = `10`
- Decal = `13`
- Animation = `24`
- Plugin = `38`
- MeshPart = `40`
- Video = `62`
- FontFamily = `73`
- Music = `300`

### Query Parameters

Expand All @@ -50,29 +48,12 @@ Use the following parameters to query the Creator Store:
<tr>
<td>categoryId (path)</td>
<td>int</td>
<td>
Audio = 3 </br>
Model = 10 </br>
Decal = 13 </br>
Animation = 24 </br>
Plugin = 38 </br>
MeshPart = 40 </br>
Video = 62 </br>
FontFamily = 73 </br>
Music = 300 </br>
SoundEffect = 301 </br>
UnknownAudio = 302 </br>
Package = 1001 </br>
SharedPackage = 1002
</td>
<td>`3` = Audio<br />`10` = Model<br />`13` = Decal<br />`24` = Animation<br />`38` = Plugin<br />`40` = MeshPart<br />`62` = Video<br />`73` = FontFamily<br />`300` = Music<br />`301` = SoundEffect<br />`302` = UnknownAudio<br />`1001` = Package<br />`1002` = SharedPackage</td>
</tr>
<tr>
<td>sortOrder</td>
<td>int</td>
<td>
Asc = 1</br>
Desc = 2
</td>
<td>`1` = Asc<br />`2` = Desc</td>
</tr>
<tr>
<td>limit</td>
Expand Down Expand Up @@ -107,10 +88,7 @@ Use the following parameters to query the Creator Store:
<tr>
<td>creatorType</td>
<td>int</td>
<td>
1 = User</br>
2 = Group
</td>
<td>`1` = User<br />`2` = Group</td>
</tr>
<tr>
<td>creatorTargetId</td>
Expand All @@ -130,11 +108,7 @@ Use the following parameters to query the Creator Store:
<tr>
<td>sortDirection</td>
<td>int</td>
<td>
None = 0</br>
Ascending = 1</br>
Descending = 2
</td>
<td>`0` = None<br />`1` = Ascending<br />`2` = Descending</td>
</tr>
<tr>
<td>artist</td>
Expand All @@ -149,23 +123,12 @@ Use the following parameters to query the Creator Store:
<tr>
<td>audioTypes</td>
<td>array[int]</td>
<td>Music = 0</br>SoundEffect = 1</td>
<td>`0` = Music<br />`1` = SoundEffect</td>
</tr>
<tr>
<td>uiSortIntent</td>
<td>int</td>
<td>
Relevance = 1</br>
Trending = 6</br>
AllTime = 7</br>
Top = 8</br>
Duration = 9</br>
DateCreated = 10</br>
DateModified = 11</br>
Creator = 12</br>
Name = 13</br>
What sort order to rank the results by
</td>
<td>What sort order to rank the results by<br /><br />`1` = Relevance<br />`6` = Trending<br />`7` = AllTime<br />`8` = Top<br />`9` = Duration<br />`10` = DateCreated<br />`11` = DateModified<br />`12` = Creator<br />`13` = Name</td>
</tr>
<tr>
<td>includeOnlyVerifiedCreators</td>
Expand Down Expand Up @@ -348,7 +311,7 @@ Use the following parameters to query the Marketplace:
<tr>
<td>CreatorType</td>
<td>byte</td>
<td>`1` = User or `2` = Group.</td>
<td>`1` = User<br />`2` = Group</td>
</tr>
<tr>
<td>CreatorName</td>
Expand All @@ -368,7 +331,7 @@ Use the following parameters to query the Marketplace:
<tr>
<td>Genres</td>
<td>byte</td>
<td>Specifies the genre for the search. The recommended approach to filtering on genres is to match the URL of a catalog page. <br />`1` = TownAndCity<br />`2` = Medieval<br />`3` = SciFi<br />`4` = Fighting<br />`5` = Horror<br />`6` = Naval<br />`7` = Adventure<br />`8` = Sports<br />`9` = Comedy<br />`10` = Western<br />`11` = Military<br />`13` = Building<br />`14` = FPS<br />`15` = RPG</td>
<td>Specifies the genre for the search. The recommended approach to filtering on genres is to match the URL of a catalog page.<br /><br />`1` = TownAndCity<br />`2` = Medieval<br />`3` = SciFi<br />`4` = Fighting<br />`5` = Horror<br />`6` = Naval<br />`7` = Adventure<br />`8` = Sports<br />`9` = Comedy<br />`10` = Western<br />`11` = Military<br />`13` = Building<br />`14` = FPS<br />`15` = RPG</td>
</tr>
<tr>
<td>Keyword</td>
Expand Down Expand Up @@ -403,56 +366,7 @@ Use the following parameters to query the Marketplace:
<tr>
<td>Subcategory</td>
<td>byte</td>
<td>
`0` = Featured<br />
`1` = All<br />
`2` = Collectibles<br />
`3` = Clothing<br />
`4` = BodyParts<br />
`5` = Gear<br />
`9` = Hats<br />
`10` = Faces<br />
`12` = Shirts<br />
`13` = TShirts<br />
`14` = Pants<br />
`15` = Heads<br />
`19` = Accessories<br />
`20` = HairAccessories<br />
`21` = FaceAccessories<br />
`22` = NeckAccessories<br />
`23` = ShoulderAccessories<br />
`24` = FrontAccessories<br />
`25` = BackAccessories<br />
`26` = WaistAccessories<br />
`27` = AvatarAnimations<br />
`37` = Bundles<br />
`38` = AnimationBundles <br />
`39` = EmoteAnimations<br />
`40` = CommunityCreations<br />
`41` = Melee<br />
`42` = Ranged<br />
`43` = Explosive<br />
`44` = PowerUp<br />
`45` = Navigation<br />
`46` = Musical<br />
`47` = Social<br />
`48` = Building<br />
`49` = Transport<br />
`54` = HeadAccessories<br />
`55` = ClassicTShirts<br />
`56` = ClassicShirts<br />
`57` = ClassicPants<br />
`58` = TShirtAccessories<br />
`59` = ShirtAccessories<br />
`60` = PantsAccessories<br />
`61` = JacketAccessories<br />
`62` = SweaterAccessories<br />
`63` = ShortsAccessories<br />
`64` = ShoesBundles<br />
`65` = DressSkirtAccessories<br />
`66` = DynamicHeads<br />
</td>

<td>`0` = Featured<br />`1` = All<br />`2` = Collectibles<br />`3` = Clothing<br />`4` = BodyParts<br />`5` = Gear<br />`9` = Hats<br />`10` = Faces<br />`12` = Shirts<br />`13` = TShirts<br />`14` = Pants<br />`15` = Heads<br />`19` = Accessories<br />`20` = HairAccessories<br />`21` = FaceAccessories<br />`22` = NeckAccessories<br />`23` = ShoulderAccessories<br />`24` = FrontAccessories<br />`25` = BackAccessories<br />`26` = WaistAccessories<br />`27` = AvatarAnimations<br />`37` = Bundles<br />`38` = AnimationBundles <br />`39` = EmoteAnimations<br />`40` = CommunityCreations<br />`41` = Melee<br />`42` = Ranged<br />`43` = Explosive<br />`44` = PowerUp<br />`45` = Navigation<br />`46` = Musical<br />`47` = Social<br />`48` = Building<br />`49` = Transport<br />`54` = HeadAccessories<br />`55` = ClassicTShirts<br />`56` = ClassicShirts<br />`57` = ClassicPants<br />`58` = TShirtAccessories<br />`59` = ShirtAccessories<br />`60` = PantsAccessories<br />`61` = JacketAccessories<br />`62` = SweaterAccessories<br />`63` = ShortsAccessories<br />`64` = ShoesBundles<br />`65` = DressSkirtAccessories<br />`66` = DynamicHeads</td>
</tr>
</tbody>
</table>
Expand All @@ -475,7 +389,7 @@ API responses return in a JSON format. The response provides asset details in th
<tbody>
<tr>
<td>assetType</td>
<td>One of the following asset type values (only returned if the item is an asset).<br />`2` = T-Shirt<br />`8` = Hat<br />`11` = Shirt<br />`12` = Pants<br />`17` = Head<br />`18` = Face<br />`19` = Gear<br />`25` = Arms<br />`26` = Legs<br />`27` = Torso<br />`28` = RightArm<br />`29` = LeftArm<br />`30` = LeftLeg<br />`31` = RightLeg<br />`41` = HairAccessory<br />`42` = FaceAccessory<br />`43` = NeckAccessory<br />`44` = ShoulderAccessory<br />`45` = FrontAccessory<br />`46` = BackAccessory<br />`47` = WaistAccessory<br />`48` = ClimbAnimation<br />`49` = DeathAnimation<br />`50` = FallAnimation<br />`51` = IdleAnimation<br />`52` = JumpAnimation<br />`53` = RunAnimation<br />`54` = SwimAnimation<br />`55` = WalkAnimation<br />`56` = PoseAnimation<br />`61` = EmoteAnimation</td>
<td>One of the following asset type values (only returned if the item is an asset).<br /><br />`2` = T-Shirt<br />`8` = Hat<br />`11` = Shirt<br />`12` = Pants<br />`17` = Head<br />`18` = Face<br />`19` = Gear<br />`25` = Arms<br />`26` = Legs<br />`27` = Torso<br />`28` = RightArm<br />`29` = LeftArm<br />`30` = LeftLeg<br />`31` = RightLeg<br />`41` = HairAccessory<br />`42` = FaceAccessory<br />`43` = NeckAccessory<br />`44` = ShoulderAccessory<br />`45` = FrontAccessory<br />`46` = BackAccessory<br />`47` = WaistAccessory<br />`48` = ClimbAnimation<br />`49` = DeathAnimation<br />`50` = FallAnimation<br />`51` = IdleAnimation<br />`52` = JumpAnimation<br />`53` = RunAnimation<br />`54` = SwimAnimation<br />`55` = WalkAnimation<br />`56` = PoseAnimation<br />`61` = EmoteAnimation</td>
</tr>
<tr>
<td>bundleType</td>
Expand Down

0 comments on commit 60288df

Please sign in to comment.