wiki:XmlRpcCheckMovieHash

CheckMovieHash

Intro

check if video file hashes are already stored in the database


Description

struct CheckMovieHash(string $token, array($moviehash, $moviehash, ...) $hashes)

Checks if given video file hashes hashes are already stored in the database.

If found, the server will return basic movie information, including IMDb ID, movie title, release year.

This information can be then used in client application to automatically fill (or verify) movie info.


Parameters

token (required)
token string identifying user's session, taken from LogIn output structure.
hashes (required)
array/list of video file hashes

Return Values

Output is returned in this structure:

  struct(
    struct( <-- list of movie info structures
      struct( <-- movie information structure (movieinfo)
        (string) [MovieHash],
        (string) [MovieImdbID],
        (string) [MovieName],
        (string) [MovieYear]
      ) [<video file hash>],
      struct( movieinfo ) [<video file hash>],
      
      ... more movie information structures go here (if any) ...
      
    ) [data],
    (double) [seconds]
  )

and contains these elements:

The returned structure contains these elements:

status
function result code, see list of status codes
data
list of movie info structures movieinfo
movieinfo
information about a movie containing:
  • MovieHash: video file hash, you can use this value to match the movie info to your input parameters
  • MovieImdbID: movie IMDb ID
  • MovieName: movie title
  • MovieYear: movie release year
seconds
time taken to execute this command on server

Implementations

There are currently no available sample implementations.


Changelog

Version 1: created this function


Examples

Input

<methodCall>
 <methodName>CheckMovieHash</methodName>
 <params>
  <param>
   <value><string>gqb4qjfkc66vb0sarm8j60o3t7</string></value>
  </param>
  <param>
   <value>
    <array>
     <data>
      <value><string>d7aa0275cace4410</string></value>
      <value><string>ca8f3c95403dd70f</string></value>
      
      ... more video file hashes go here (if any) ...
      
     </data>
    </array>
   </value>
  </param>
 </params>
</methodCall>

Output

<methodResponse>
 <params>
  <param>
   <value>
    <struct>
     <member>
      <name>status</name>
      <value><string>200 OK</string></value>
     </member>
     <member>
      <name>data</name>
      <value>
       <struct>
        <member>
         <name>d7aa0275cace4410</name>
         <value>
          <struct>
           <member>
            <name>MovieHash</name>
            <value><string>d7aa0275cace4410</string></value>
           </member>
           <member>
            <name>MovieImdbID</name>
            <value><string>371746</string></value>
           </member>
           <member>
            <name>MovieName</name>
            <value><string>Iron Man</string></value>
           </member>
           <member>
            <name>MovieYear</name>
            <value><string>2008</string></value>
           </member>
          </struct>
          
          ... more movie information structures go here (if any) ...
          
         </value>
        </member>
       </struct>
      </value>
     </member>
     <member>
      <name>seconds</name>
      <value><double>3.525</double></value>
     </member>
    </struct>
   </value>
  </param>
 </params>
</methodResponse>

Notes

none yet


See also


Comments

add your comments, hints and suggestions here if you like ...


[Prev] Home [Next]

Last modified 10 years ago Last modified on Sep 28, 2008, 1:24:34 PM