Changes between Version 116 and Version 117 of XMLRPC

Timestamp:

Apr 20, 2017, 9:29:51 AM (8 years ago)

Author:

os

Comment:

--

XMLRPC

@@ -12 +12 @@
  * [wiki:DevReadFirst Read this first] - Before developing let us know, we assign useragent to you, empty useragent or unregistered UA will not work.
  * before using this XML-RPC is required to have implementation for [wiki:HashSourceCodes OS HASH]
+ * we start support HTTPS, if you need it - you can use '''https://api.opensubtitles.org:443/xml-rpc'''
  * XML-RPC requests send to '''http://api.opensubtitles.org:80/xml-rpc''',  you may be interested in more verbose version of [wiki:XmlRpcIntro XML-RPC methods with examples]
- * we start support HTTPS, if you need it - you can use '''https://api.opensubtitles.org:443/xml-rpc'''
+ * API Request limit: 40 HTTP requests per 10 seconds per IP address, read here more https://forum.opensubtitles.org/viewtopic.php?f=8&t=16072
  * For languages codes, check [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO639], use '''pb/pob''' for Portuguese (Brazil) - [http://www.opensubtitles.org/addons/export_languages.php Download OS languages table dump]
- * IMDB ID is meant to be NUMBER from link of IMDB movie. Example: http://www.imdb.com/title/tt0133093/ - IMDB ID is '0133093' (removing trailing zero is also OK).
+ * IMDB ID is meant to be NUMBER from link of IMDB movie. Example: http://www.imdb.com/title/tt0133093/ - IMDB ID is '0133093' (removing leading 0 is also OK).
  * PHP: for gzip compression use function which adds no header to output, [http://www.php.net/manual/en/function.gzcompress.php gzcompress] - this means, in your programming language you might look for '''zlib''' instead of gzip. For decompression is used [http://www.php.net/gzuncompress gzdecompress].
  * PHP: if you download subtitles from XML-RPC, use: gzinflate(substr(base64_decode($subs_b64_data_from_xmlrpc),10)), if gz from web: gzinflate(substr($gz_subtitles),10);  
@@ -1346 +1347 @@
  * 506 Server under maintenance
 
+'''HTTP RESPONSE CODES'''
+ * 200 OK (this should be default response)
+
+ * 429 Too many requests (too many requests sent, read more https://forum.opensubtitles.org/viewtopic.php?f=8&t=16072)
+
+ * 503 Service Unavailable (when server is under heavy load, it is temporary, retry in 1 second)
+
 
 = !UserRank lists =