Changes between Version 19 and Version 20 of XMLRPC

Timestamp:

Dec 10, 2008, 9:48:42 AM (16 years ago)

Author:

os

Comment:

--

XMLRPC

@@ -213 +213 @@
 '''array !CheckMovieHash( $token, array($moviehash, $moviehash, ...) )'''
 
-This method returns !MovieImdbID, !MovieName, !MovieYear, if available for each $moviehash.
-
-Example output:
-{{{
+This method returns best matching !MovieImdbID, !MovieName, !MovieYear, if available for each $moviehash. See also !CheckMovieHash2()
+
+Example output:
+{{{
+    [status] => 200 OK
     [data] => Array
         (
             [dab462412773581c] => Array
                 (
+                    [MovieHash] => dab462412773581c
                     [MovieImdbID] => 133152
                     [MovieName] => Planet of the Apes
                     [MovieYear] => 2001
                 )
+
             [ae34f157eefc093c] => Array
                 (
+                    [MovieHash] => ae34f157eefc093c
                     [MovieImdbID] => 288477
                     [MovieName] => Ghost Ship
                     [MovieYear] => 2002
                 )
+
             [abcdefg123211222] => Array
                 (
                 )
+
         )
-    [seconds] => 0.046
-}}}
-
-'''Fields explanation:'''
-Array in data contains $moviehash => array()
+
+    [seconds] => 0.133
+}}}
+
+'''Fields explanation:'''
+Array in data contains $moviehash => array(), even for unmatched moviehashes.
+
+----
+
+== !CheckMovieHash2 ==
+'''array !CheckMovieHash2( $token, array($moviehash, $moviehash, ...) )'''
+
+This method returns matching !MovieImdbID, !MovieName, !MovieYear, if available for each $moviehash, always sorted by !SeenCount DESC.
+
+Example output:
+{{{
+    [status] => 200 OK
+    [data] => Array
+        (
+            [3b2ae156d8c11f7a] => Array
+                (
+                    [0] => Array
+                        (
+                            [MovieHash] => 3b2ae156d8c11f7a
+                            [MovieImdbID] => 103644
+                            [MovieName] => Alien³
+                            [MovieYear] => 1992
+                            [SeenCount] => 48
+                        )
+
+                    [1] => Array
+                        (
+                            [MovieHash] => 3b2ae156d8c11f7a
+                            [MovieImdbID] => 133093
+                            [MovieName] => The Matrix
+                            [MovieYear] => 1999
+                            [SeenCount] => 5
+                        )
+
+                )
+
+            [53fc6fe84ad5ee31] => Array
+                (
+                    [0] => Array
+                        (
+                            [MovieHash] => 53fc6fe84ad5ee31
+                            [MovieImdbID] => 813715
+                            [MovieName] => "Heroes"
+                            [MovieYear] => 2006
+                            [SeenCount] => 427
+                        )
+
+                    [1] => Array
+                        (
+                            [MovieHash] => 53fc6fe84ad5ee31
+                            [MovieImdbID] => 1185913
+                            [MovieName] => "Heroes" One of Us, One of Them
+                            [MovieYear] => 2008
+                            [SeenCount] => 260
+                        )
+
+                )
+        ...
+}}}
+
+'''Fields explanation:'''
+Array in data contains $moviehash => array(), '''only''' for matched moviehashes.
+
+----
+
+== !InsertMovieHash ==
+'''array !InsertMovieHash( $token, array( array('moviehash' => $moviehash, 'moviebytesize' => $moviebytesize, 'imdbid' => $imdbid, 'movietimems' => $movietimems, 'moviefps' => $moviefps, 'moviefilename' => $moviefilename), array(...) ) )'''
+
+Inserts or updates data to tables, which are used for !CheckMovieHash() and !CheckMovieHash2(). Requested parameters are: '''moviehash, moviebytesize, imdbid''', all rest parameters are '''optional''', but preferred to supply them. Before accepting moviehashes, each moviehash is checked against log table if user doesn't already send it.
+
+Example output:
+{{{
+    [status] => 200 OK
+    [data] => Array
+        (
+            [accepted_moviehashes] => Array
+                (
+                    [0] => 53fc6fe84ad5ee31
+                    [1] => 3b2ae156d8c11f7a
+                )
+
+            [new_imdbs] => Array
+                (
+                )
+
+        )
+
+    [seconds] => 0.014
+}}}
+
+'''Fields explanation:'''
+accepted_moviehashes - hashes, which was inserted or updated, new_imdbs - imdb ids need to download from imdb.com
 
 ----