GET api/v1/media/ByUniqueName/{name}/latest

Returns the latest media item currently assigned to the unique media name. This acts as a kind of perma-link to a every changing image (e.g. time delayed snapshots)

Request Information

URI Parameters

NameDescriptionTypeAdditional information
name

Unique Name to filter by

string

Required

Body Parameters

None.

Response Information

Resource Description

MediaItemDto
NameDescriptionTypeAdditional information
Id

Id

globally unique identifier

None.

UserId

Published by this user/member/device

globally unique identifier

None.

ContentType

Content type (png, jpg, etc).

string

None.

Caption

A caption to go with the item. This will be used as status post text if the CreateStatusPost option is set to true

string

None.

Description

Option description to go with the photo

string

None.

UniqueMediaName

A Unique name that is associated with media items. When media is requested using the UniqueMediaName it can show the latest or a stream of the media associated with the name.

string

None.

Location

Location this photo was taken (or of)

LocationDto

None.

Tags

Tags to associate with the photo

Collection of string

None.

Links

List of the links (e.g. self)

Collection of LinkDto

None.

Actions

List of actionable links (e.g. delete)

Collection of LinkDto

None.

DateAdded

When the item was added.

date

None.

LastUpdated

When the item was last updated

date

None.

Private

If this media item is flagged as private to the individual account.

boolean

None.

Response Formats

application/json, text/json, application/senml+json

Sample:
{
  "Id": "df6f5e2c-f6e3-43cb-9c51-1f927bcfd23d",
  "UserId": "10d7dc9d-0ee8-4ab8-be82-5ac2204a45b9",
  "ContentType": "sample string 3",
  "Caption": "sample string 4",
  "Description": "sample string 5",
  "UniqueMediaName": "sample string 6",
  "Location": {
    "Name": "sample string 1",
    "Latitude": 2.1,
    "Longitude": 3.1,
    "Elevation": 4.1,
    "WellKnownLocationId": "3b0cbe4f-92b2-4ad7-a320-426fa3dd7f5e",
    "LastUpdated": "2024-12-21T04:25:37.1438195+00:00"
  },
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Links": [
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    }
  ],
  "Actions": [
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    }
  ],
  "DateAdded": "2024-12-21T04:25:37.1438195+00:00",
  "LastUpdated": "2024-12-21T04:25:37.1438195+00:00",
  "Private": true
}

application/xml, text/xml

Sample:
<MediaItemDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Media">
  <Actions xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
  </Actions>
  <Caption>sample string 4</Caption>
  <ContentType>sample string 3</ContentType>
  <DateAdded>2024-12-21T04:25:37.1438195+00:00</DateAdded>
  <Description>sample string 5</Description>
  <Id>df6f5e2c-f6e3-43cb-9c51-1f927bcfd23d</Id>
  <LastUpdated>2024-12-21T04:25:37.1438195+00:00</LastUpdated>
  <Links xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
  </Links>
  <Location xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:Elevation>4.1</d2p1:Elevation>
    <d2p1:LastUpdated>2024-12-21T04:25:37.1438195+00:00</d2p1:LastUpdated>
    <d2p1:Latitude>2.1</d2p1:Latitude>
    <d2p1:Longitude>3.1</d2p1:Longitude>
    <d2p1:Name>sample string 1</d2p1:Name>
    <d2p1:WellKnownLocationId>3b0cbe4f-92b2-4ad7-a320-426fa3dd7f5e</d2p1:WellKnownLocationId>
  </Location>
  <Private>true</Private>
  <Tags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Tags>
  <UniqueMediaName>sample string 6</UniqueMediaName>
  <UserId>10d7dc9d-0ee8-4ab8-be82-5ac2204a45b9</UserId>
</MediaItemDto>