| Version 1 (modified by guest, 16 years ago) (diff) |
|---|
Introduction to OSDb
Sections
We decided use XMLRPC (see spec and implementations) as default API for opensubtitles.org.
Our API supports many methods so there should be no problems to code some nice client applications.
Wikipedia: XML-RPC is a very simple protocol, defining only a handful of data types and commands and the entire description can be printed on two pages of paper. This is in stark contrast to most RPC systems, where the standards documents often run into the hundreds of pages and require considerable software support in order to be used.
Instructions
- Read this first
- All development testing should be pointed to: http://dev.opensubtitles.org/xml-rpc (currently offline, so use main server)
- Main/Production? server XMLRPC URL: http://www.opensubtitles.org/xml-rpc
- Before developing let us know and we will assign/agree on useragent code for your application.
- For languages codes, check ISO639, use pb/pob for Portuguese (Brazil) - Download OS languages table dump
- For gzip compression use function which adds no header to output, for PHP it's: gzcompress. For decompression use gzdecompress.
XMLRPC methods
Session handling
- LogIn - login user and start session
struct LogIn( string $username, string $password, string $language, string $useragent )
- LogOut - logout user
- NoOperation - keep-alive user's session, verify token/session validity
Search and download
- SearchSubtitles - search for subtitles using video hashes or IMDb ID
- SearchToMail - search for subtitles, send result to e-mail address
- DownloadSubtitles - download given subtitle files
Upload
- TryUploadSubtitles - check subtitles before uploading
- UploadSubtitles - upload given subtitle
Movies
- SearchMoviesOnIMDB -
- GetIMDBMovieDetails - get movie details fro given IMDb ID
- InsertMovie - insert a new movie
Reporting and rating
- ServerInfo - get basic server information and statistics
- ReportMovieHash - report wrong
- SubtitlesVote - rate subtitles
User interface
- GetSubLanguages - get support subtitle languages
- DetectLanguage - detect language for given text
- GetAvailableTranslations - get list of available translations for a client application
- GetTranslation - get given language translation file for a client application
- AutoUpdate - check for latest version of a client application
Checking
Credits
- 2ge - writer of OSDb XML-RPC server-side implementation
- eduo - supplier of various example inputs/outputs
- all other contributors
