Difference between revisions of "Content Service"

From MythTV Official Wiki
Jump to: navigation, search
Line 173: Line 173:
 
==GetVideoArtwork==
 
==GetVideoArtwork==
  
The <span style="color:LimeGreen">GetRecordingArtwork</span> API takes the following arguments:
+
The <span style="color:LimeGreen">GetVideoArtwork</span> API takes the following arguments:
  
 
:<span style="color:SteelBlue">Id</Span> ('''Required''')
 
:<span style="color:SteelBlue">Id</Span> ('''Required''')
 
:: '''Parameter Type:''' String
 
:: '''Parameter Type:''' String
:: The inetref for the recording you are looking up.  This information is available in the VideoMetadataInfo construct, which can be queried in the Video Service.
+
:: The database id for the video you are looking up.  This information is available in the VideoMetadataInfo construct, which can be queried in the Video Service.
  
 
:<span style="color:SteelBlue">Type</Span> ('''Optional''')
 
:<span style="color:SteelBlue">Type</Span> ('''Optional''')
Line 194: Line 194:
  
 
<code>http://BackendServerIP:6544/Content/GetVideoArtwork?Id=100&Type=fanart</code>
 
<code>http://BackendServerIP:6544/Content/GetVideoArtwork?Id=100&Type=fanart</code>
 +
 +
Example Return:
 +
 +
The return for this command is a ''binary file'' which will be interpreted by your browser and downloaded or displayed as appropriate.
 +
 +
==GetAlbumArt==
 +
 +
The <span style="color:LimeGreen">GetAlbumArt</span> API takes the following arguments:
 +
 +
:<span style="color:SteelBlue">Id</Span> ('''Required''')
 +
:: '''Parameter Type:''' String
 +
:: The database id for the album you are looking up.
 +
 +
:<span style="color:SteelBlue">Width</Span> ('''Optional''')
 +
:: '''Parameter Type:''' Integer
 +
:: The scaled width to return the image.  To preserve proper aspect, you may want to specify only one of width or height.
 +
 +
:<span style="color:SteelBlue">Height</Span> ('''Optional''')
 +
:: '''Parameter Type:''' Integer
 +
:: The scaled height to return the image.  To preserve proper aspect, you may want to specify only one of width or height.
 +
 +
Example Query:
 +
 +
<code>http://BackendServerIP:6544/Content/GetAlbumArt?Id=585</code>
  
 
Example Return:
 
Example Return:
  
 
The return for this command is a ''binary file'' which will be interpreted by your browser and downloaded or displayed as appropriate.
 
The return for this command is a ''binary file'' which will be interpreted by your browser and downloaded or displayed as appropriate.

Revision as of 21:29, 2 October 2011

Content Service API List

API Command POST Required? Description
GetFile No Download a given file from a given storage group.
GetImageFile No Display, and optionally scale, an image file from a given storage group.
GetFileList No Get a list of files in a specified storage group.
GetRecordingArtwork No Display, and optionally scale, an image file of a given type (coverart, banner, fanart) for a given recording's inetref and season number.
GetVideoArtwork No Display, and optionally scale, an image file of a given type (coverart, banner, fanart) for a given video's database id number.
GetAlbumArt No Display, and optionally scale, the album art for a given music file's database id number.
GetPreviewImage No Display, and optionally scale, an preview thumbnail for a given recording by timestamp, chanid and starttime.
GetRecording No Download a given recording file by chanid and starttime.
GetMusic No Download a given music file by database id.
GetVideo No Download a given video by database id.
GetHash No Perform a unique identifying hash on a given file in a given storage group.
DownloadFile No Instruct the backend to download a remote file into a storage group.

Content APIs

GetFile

The GetFile API takes the following arguments:

StorageGroup (Required)
Parameter Type: String
The Storage Group name in which you wish to search for the file.
Filename (Required)
Parameter Type: String
The filename (and relative path if necessary) of the file you wish to receive.

Example Query:

http://BackendServerIP:6544/Content/GetFile?StorageGroup=Recordings&FileName=244001_20110922210000.mpg

Example Return:

The return for this command is a binary file which will be interpreted by your browser and downloaded or displayed as appropriate.

GetImageFile

The GetImageFile API takes the following arguments:

StorageGroup (Required)
Parameter Type: String
The Storage Group name in which you wish to search for the file.
Filename (Required)
Parameter Type: String
The filename (and relative path if necessary) of the file you wish to receive.
Width (Optional)
Parameter Type: Integer
The scaled width to return the image. To preserve proper aspect, you may want to specify only one of width or height.
Height (Optional)
Parameter Type: Integer
The scaled height to return the image. To preserve proper aspect, you may want to specify only one of width or height.

Example Query:

http://BackendServerIP:6544/Content/GetImageFile?StorageGroup=Fanart&FileName=9461_fanart.jpg&Width=200

Example Return:

The return for this command is a binary file which will be interpreted by your browser and downloaded or displayed as appropriate.

GetFileList

The GetFileList API takes the following arguments:

StorageGroup (Required)
Parameter Type: String
The Storage Group name for which you wish to see a list of files.

Example Query:

http://BackendServerIP:6544/Content/GetFileList?StorageGroup=Fanart

Example Return:

<?xml version="1.0" encoding="UTF-8"?>
<QStringList>
    <String>10020_fanart.jpg</String>
    <String>10074_fanart.jpg</String>
    <String>10126_fanart.jpg</String>
    <String>10138_fanart.jpg</String>
    <String>10139_fanart.jpg</String>
    <String>10140_fanart.jpg</String>
    <String>10189_fanart.jpg</String>
    <String>10191_fanart.jpg</String>
    <String>10192_fanart.jpg</String>
    <String>10196_fanart.jpg</String>
</QStringList>

GetRecordingArtwork

The GetRecordingArtwork API takes the following arguments:

Inetref (Required)
Parameter Type: String
The inetref for the recording you are looking up. This information is available in the Program construct, which can be queried in the DVR Service.
Type (Optional)
Parameter Type: String
The type of artwork you wish to download. Valid types are coverart, fanart, and banner. If no type is present, the query will fall back to coverart.
Season (Optional)
Parameter Type: Integer
The season number of the artwork you wish to receive. If no season number is present, the query will fall back to the latest available season.
Width (Optional)
Parameter Type: Integer
The scaled width to return the image. To preserve proper aspect, you may want to specify only one of width or height.
Height (Optional)
Parameter Type: Integer
The scaled height to return the image. To preserve proper aspect, you may want to specify only one of width or height.

Example Query:

http://BackendServerIP:6544/Content/GetRecordingArtwork?Inetref=80552&Type=fanart&Season=2

Example Return:

The return for this command is a binary file which will be interpreted by your browser and downloaded or displayed as appropriate.

GetVideoArtwork

The GetVideoArtwork API takes the following arguments:

Id (Required)
Parameter Type: String
The database id for the video you are looking up. This information is available in the VideoMetadataInfo construct, which can be queried in the Video Service.
Type (Optional)
Parameter Type: String
The type of artwork you wish to download. Valid types are coverart, fanart, and banner. If no type is present, the query will fall back to coverart.
Width (Optional)
Parameter Type: Integer
The scaled width to return the image. To preserve proper aspect, you may want to specify only one of width or height.
Height (Optional)
Parameter Type: Integer
The scaled height to return the image. To preserve proper aspect, you may want to specify only one of width or height.

Example Query:

http://BackendServerIP:6544/Content/GetVideoArtwork?Id=100&Type=fanart

Example Return:

The return for this command is a binary file which will be interpreted by your browser and downloaded or displayed as appropriate.

GetAlbumArt

The GetAlbumArt API takes the following arguments:

Id (Required)
Parameter Type: String
The database id for the album you are looking up.
Width (Optional)
Parameter Type: Integer
The scaled width to return the image. To preserve proper aspect, you may want to specify only one of width or height.
Height (Optional)
Parameter Type: Integer
The scaled height to return the image. To preserve proper aspect, you may want to specify only one of width or height.

Example Query:

http://BackendServerIP:6544/Content/GetAlbumArt?Id=585

Example Return:

The return for this command is a binary file which will be interpreted by your browser and downloaded or displayed as appropriate.