CSN-DTO MediaItem
A standardised format for the transfer of media within the automotive industry globally. This is developed and in use by carsales.com Limited and its local and international entities. For more information, please see it's GitHub repo.
Below is a comprehensive overview of each of the parameters that CSN-DTO MediaItem supports, and each type of media they apply to.
Required parameters
These are the required parameters within the CSN-DTO MediaItem and its derivities. Requests cannot be completed without these parameters.
| Name | Type | MediaItem | Description |
|---|---|---|---|
Type | string | All | The source that the media was created from. Applicable types for media sent via Global Inventory are: - DEALER - LESA - SPIN (videos only) |
Order | int | All | The position of the media within a inventory item's media collection. Order can start at either 0 or 1. Defaults to 0 if omitted Note After the photos are processed, the photo array is zero-indexed. |
Url | string | All | Absolute path of the media to be uploaded. The media item must be accessible on the public internet. Applicable file extensions for images sent via Global Inventory are: - .jpg - .jpeg - .png Applicable file extensions for videos sent via Global Inventory are: - .mp4 - .mov The file extension requirement applies to standard videos only. It does not apply to a video with Type of SPIN, which only needs a valid absolute URL. |
Optional parameters
The following are optional parameters supported by CSN-DTO MediaItem.
| Name | Type | MediaItem | Description |
|---|---|---|---|
Tags | Tag[] | All | See the Tags page for details |
ThumbUrl | string | Spin | Absolute URL of a thumbnail image for the Spin. |
ThumbSmallUrl | string | Spin | Absolute URL of a small thumbnail image for the Spin. |
Examples
Below are example MediaItem payloads.
Video
{
"Type": "DEALER",
"Url": "https://www.learningcontainer.com/wp-content/uploads/2020/05/sample-mp4-file.mp4",
"Tags": [
{
"Name": "SomeName",
"Value": "SomeValue"
}
]
}Spin
{
"Type": "SPIN",
"Url": "https://spins.spincar.com/mydealership/abcd1234video",
"ThumbUrl": "https://cdn.impel.io/swipetospin-viewers/mydealership/abcd1234video/20260903032350.8IVCADCT/thumb-lg.jpg",
"ThumbSmallUrl": "https://cdn.impel.io/swipetospin-viewers/mydealership/abcd1234video/20260903032350.8IVCADCT/thumb-lg.jpg"
}Two Photos
[
{
"type": "DEALER",
"url": "https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png?20120323050937",
"order": 1,
"tags": [
{
"name": "SomeName",
"value": "SomeValue"
}
]
},
{
"type": "DEALER",
"url": "https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png?20120323050937",
"order": 2,
"tags": [
{
"name": "SomeName",
"value": "SomeValue"
}
]
}
]