Get content details by ID. This is a faceted view with the following facets:
GET /api/v1/content/fbca3f66-e33b-4125-8384-c753a10d659f HTTP/1.1
Accept: application/json
----------------------------------------
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
ETag: ...
{
"id": "fbca3f66-e33b-4125-8384-c753a10d659f",
"revisionId": "c83ffc2e-25b0-48ac-9c5f-51e638ecb30b",
"listingId": 231,
"author": {
"id": "c13c874c-a9d6-487a-b331-a1118ca995a3",
"username": "iRefactor",
"avatar": "protected/us-west-2:c13c874c-a9d6-487a-b331-a1118ca995a3/ddcdfa09-cc3e-45ea-b977-dc178481a7bd.png",
"emblem": null
},
"status": "active",
"type": "game",
"maxFileSize": 214326,
"version": "2",
"created": 1537907432,
"updated": 1537907471,
"name": "test6",
"description": "asdfasdfasdfsadf",
"screenshotUris": ["protected/us-west-2:c13c874c-a9d6-487a-b331-a1118ca995a3/fbca3f66-e33b-4125-8384-c753a10d659f/699b56e5-c605-454c-aa86-c7059f4566c1.png"],
"tags": [],
"featured": true,
"featuredListingId": 301,
"downloads": "0",
"views": "23",
"upvotes": "100",
"downvotes": "100",
"rating": "0.5"
}Authentication is not generally required for this method, but certain content items are restricted to certain users based on their status.
| Name | Description | Value |
|---|---|---|
| contentId | the ID of the content as a GUID with dashes | string |
| Name | Description | Value |
|---|---|---|
| facet | select a facet to return optional | one of:
|
NONE
Successful responses are code 200 with data in the response body. Error responses are standard.
| Name | Description | Value |
|---|---|---|
| id | the ID of the content as a GUID with dashes | string |
| revisionId | the ID of the revision as a GUID with dashes | string |
| listingId | the ID of the most recent listing | number |
| author | an object describing the author of the content | object; UserSimplified |
| status | the status of the content item | one of:
|
| type | the category of the content item | one of:
|
| maxFileSize | the sum of the file sizes of all dependencies for the latest revision, in bytes | number |
| version | the version number of the latest revision | string |
| created | when this item was first published, as a unix timestamp | number |
| updated | when this item was last updated, as a unix timestamp | number |
| name | the name of this content item | string |
| description | the description of this content item | string |
| screenshotUris | an array of screenshots, as paths relative to the media S3 bucket; the first screenshot is assumed to be the primary image | array of strings |
| tags | an array of tags assigned to this content | array of strings |
| featured | true if this content is featured, false otherwise | boolean |
| featuredListingId | the listing ID that is featured, if this content is featured | number or null |
| downloads | the number of times this content has been downloaded | number |
| views | the number of times this content has been viewed | number |
| upvotes | the number of times this content has been upvoted | number |
| downvotes | the number of times this content has been downvoted | number |
| rating | the calculated rating for this content; a value between 0 and 1 | number |
| Name | Description | Value |
|---|---|---|
| id | the ID of the user as a GUID with dashes | string |
| username | the user's username, which is unique | string |
| avatar | a media path to the user's avatar image file; will be null if no avatar has been set | string or null |
| emblem | the GUID of an emblem to display with the user's avatar, or null if none is selected | string or null |
Everything from the default facet plus:
| Name | Description | Value |
|---|---|---|
| manifest | a description of the dependencies for this content item | object; see manifest definition |
Everything from the default facet except: revisionId, version, maxFileSize, and updated; and plus:
| Name | Description | Value |
|---|---|---|
| revisions | an array of revision objects describing all known revisions to this content item | array of objects; see Revision |
| Name | Description | Value |
|---|---|---|
| id | the revision ID as a GUID with dashes | string |
| contentId | the content ID as a GUID with dashes | string |
| created | when this revision was published, as a unix timestamp | number |
| description | the change notes for this revision | string |
| version | the version number for this revision | string |
| maxFileSize | the sum of the file sizes of all dependencies for this revision, in bytes | number |