Placeholder [otr] means http://www.onlinetvrecorder.com
At each file you need to attach additional parameters, described in the following:
Login
[otr]/downloader/api/login.php
• |
?email= |
Email-Address |
• |
&pass= |
Password |
• |
&did= |
Programm-Id |
• |
&checksum= |
Checksum |
After succesful Login the SessionId will be returned.
It is not allowed to transfer, analyse, store, publish or forward entered login data!
Show recording list
[otr]/downloader/api/request_list2.php
• |
?showonly= |
[recordings, scheduled, archive] |
• |
&orderby= |
[genre, genre_desc, station, station_desc, time, time_desc, title, title_desc] |
• |
&did= |
Program-Id |
• |
&checksum= |
Checksum |
Optionale Parameter
• |
&maxitems= |
[1..100] |
|
• |
&status_scheduled= |
[false] |
Don’t display 'scheduled'-Status |
• |
&status_recording= |
[false] |
Don`t display 'recording'-Status |
• |
&status_ready= |
[false] |
Don’t`t display 'ready for download'-Status |
• |
&status_downloaded= |
[false] |
~ |
• |
&status_decoded= |
[false] |
~ |
• |
&status_paid= |
[false] |
~ |
• |
&status_bad= |
[false] |
~ |
• |
&status_pending= |
[false] |
~ |
• |
&status_expected= |
[false] |
~ |
• |
&unsupportedstation= |
[false] |
~ |
• |
&status_unknownstation= |
[false] |
~ |
• |
&status_removed= |
[false] |
~ |
A XML-File with the following structure will be returned:
<FILE>
<ID>12</ID>
<EPGID>34</EPGID>
<DOWNLOADCOUNT>0</DOWNLOADCOUNT>
<DECODECOUNT>0</DECODECOUNT>
<PAID>[ja/nein]</PAID>
<STATION>w</STATION>
<TITLE>x</TITLE>
<GENRE>y</GENRE>
<BEGIN>56</BEGIN>
<END>78</END>
<STATUS>z</STATUS>
<FORMATS>x</FORMATS>
<FILENAME>fn</FILENAME>
<DURATION>12 Minuten</DURATION>
<FILEREQUEST>http://www.onlinetvrecorder.com/downloader/api/request_file2.php</FILEREQUEST>
</FILE>
Information about a file
[otr]/downloader/api/request_file2.php
• |
?id= |
given |
• |
&epgid= |
given |
• |
&file= |
given |
• |
&did= |
Program-Id |
• |
&checksum= |
Checksum |
A XML-File with the following structure will be returned:
< [AVI|HQ|MP4....] > // Format
<FILENAME></FILENAME>
<SIZE></SIZE>
<FREE>http://downloadlink...</FREE>
<PRIO>http://downloadlink...</PRIO>
<PAID>http://downloadlink...</PAID>
<IPHONE>http://downloadlink...</IPHONE>
<MOBILE>http://playerlink...</MOBILE>
<TORRENT>
<FREE>http://downloadlink...</FREE>
<DIRECT>http://downloadlink...</DIRECT>
<PRIO>http://downloadlink...</PRIO>
<PAID>http://downloadlink...</PAID>
<COMBI>http://downloadlink...</COMBI>
</TORRENT>
<GWPCOSTS>
<FREE></FREE>
<PRIO></PRIO>
<PAID></PAID>
</GWPCOSTS>
<MIRROR>http://mirrorlink...</MIRROR>
<INFOTEXT></INFOTEXT>
< /[AVI|HQ|MP4] >
If there is more than one format, this block will be called multiple times.
Please call this file only in case of downloading the respective file.
Request user information
[otr]/downloader/api/userinfo.php
• |
&did= |
Program-Id |
• |
&checksum= |
Checksum |
• |
&email= |
E-Mail, Base64-encoded |
A XML-File with the following structure will be returned:
<USER>
<ID></ID>
<EMAIL></EMAIL>
<STATUS></STATUS>
<UNTIL>End of current status as unix timestamp</UNTIL>
<UNTILNICE></UNTILNICE>
<GWP></GWP>
</USER>
Search show
[otr]/index.php
• |
&aktion=search |
|
• |
&api=true |
|
• |
&future=true |
|
• |
&searchterm= |
Search term |
A XML-File with the following structure will be returned:
<SHOW>
<EPGID></EPGID>
<STATION></STATION>
<BEGIN></BEGIN>
<NICEBEGIN></NICEBEGIN>
<END></END>
<NICEEND></NICEEND>
<TITLE></TITLE>
<PROGRAMLINK></PROGRAMLINK>
</SHOW>
get station list
[otr]/downloader/api/stations.php
A XML-File with the following structure will be returned:
<ITEM>
<TITLE></TITLE>
<COUNTRY></COUNTRY>
<LANGUAGE></LANGUAGE>
</ITEM>
display banner
[otr]/downloader/api/request_banner.php
• |
&did= |
Program-Id |
• |
&checksum= |
Checksum |
decode (OnTheFlyDecoding)
[otr]/index.php
• |
&aktion=testdecoding |
|
• |
&email= |
E-Mail-Address of OTR-User |
• |
&password= |
Password of OTR-User (here a special „Mirror-Password“ is meant. This password can be defined additionally by user in his profile and is only valid for 30 days) |
• |
&filename= |
Original Dateiname, inklusive der Endung .otrkey |
• |
&mirror= |
URL Ihrer Mirror-Homepage |
If specified user is entitled to decode the file, „OK“ will be returned, otherwise „Error“.
Please note: Decoding is not necessary in most cases. Most of the files are available uncoded = playable AVI direct on otr-server. OTR storage time is only 14 days up to 6 weeks for blockbusters. Only for very old files , a mirror access is necessary. Mirror only store coded files.
Note: It is not allowed to store, analyse, publish, transfer or forward login data of users. Please tell users, that a successful request will cost 1 decoding-point.
Add a new schedule for a show
we have 2 ways to schedule a new show.
[otr]/index.php
• |
&aktion=createJob |
|
• |
&email= |
E-Mail-Address from OTR-User |
• |
&pass= |
Password from OTR-User |
• |
&tvStation= |
Name of tv station |
• |
&stateDate_day= |
Start-Day of schedule, Format DD |
• |
&stateDate_month= |
Start-Month of schedule, Format MM |
• |
&stateDate_year= |
Start-Year of schedule, Format YYYY |
• |
&startTime_hour= |
Start-Hour of schedule, Format HH |
• |
&startTime_minute= |
Start-Minutes of schedule, Format MM |
• |
&endTime_hour= |
End-Hour of schedule, Format HH |
• |
&endTime_minute= |
End-Minute of schedule, Format MM |
• |
&titleName= |
Titel of schedule |
- or -
[otr]/index.php
• |
&aktion=createJob |
|
• |
&email= |
E-Mail-Address from OTR-User |
• |
&pass= |
Password from OTR-User |
• |
&byid=true |
|
• |
&epgid= |
EPG-Id, base64-encoded |
Delete a scheduled recording
[otr]/index.php
• |
&aktion=deleteJob |
|
• |
&uid= |
E-Mail-Address or Id from OTR-User, base64-encoded |
• |
&epgid= |
EPG-Id of scheduled show, base64-encoded |
Export a EPG-List
[otr]/index.php
• |
&aktion=epg_export |
|
• |
&format=xml |
|
• |
&btn_ok=OK |
|
• |
&stations= |
Name of stations according to station XML, multiple separated by comma (“,”) |
• |
&from= |
Start-Date, Format: dd.mm.YYYY |
• |
&to= |
End-Date, Format: dd.mm.YYYY |
A XML-File with the following structure will be returned:
<ITEM>
<Id>[EPG-Id]</Id>
<BEGINN></BEGINN>
<ENDE></ENDE>
<DAUER></DAUER>
<SENDER></SENDER>
<TITEL></TITEL>
<TYP>[Genre]</TYP>
<TEXT>[ggf. Infotexte]</TEXT>
<HIGHLIGHT></HIGHLIGHT>
<FSK></FSK>
<WEEKDAY></WEEKDAY>
<WDH>0</WDH>
<NICEDATE></NICEDATE>
<DOWNLOADLINK></DOWNLOADLINK>
<INFOLINK></INFOLINK>
<PROGRAMLINK></PROGRAMLINK>
</ITEM>
Get EPG-Data for a show
[otr]/downloader/api/epg.php
• |
&epg_id= |
EPG-Id |
• |
&did= |
Program-Id |
• |
&checksum= |
Checksum |
A XML-File with the following structure will be returned:
<ITEM>
<ID>[EPG-Id]</ID>
<BEGIN></BEGIN>
<NICEBEGIN></NICEBEGIN>
<END></END>
<NICEEND></NICEEND>
<DURATION></DURATION>
<STATION></STATION>
<TITLE></TITLE>
<TYP></TYP>
<TEXT></TEXT>
<HIGHLIGHT></HIGHLIGHT>
<FSK></FSK>
<WEEKDAY></WEEKDAY>
<WDH></WDH>
<PROGRAMINGS></PROGRAMINGS>
<DOWNLOADLINK></DOWNLOADLINK>
<PROGRAMLINK></PROGRAMLINK>
</ITEM>
Create a FTP-Push-job
[otr]/downloader/api/ftppush.php
• |
&filename= |
Complete filename |
• |
&host= |
Host |
• |
&port= |
Port |
• |
&username= |
Login-Username |
• |
&password= |
Login-Password |
• |
&directory= |
Upload-directory, must begin with "/" |
A XML-File with the following structure will be returned:
<ITEM>
<FTPPUSH_ID></FTPPUSH_ID>
<RESULT>"DOUBLE", "ERROR" oder "ADDED"</RESULT>
<CHECKLINK></CHECKLINK>
<DELETELINK></DELETELINK>
</ITEM>
Delete FTP-Push-job
[otr]/downloader/api/deleteftppush.php
• |
&ftppush_id= |
ID of FTP-Push-job |
A XML-File with the following structure will be returned:
<ITEM>
<RESULT>"OK" oder "ERROR"</RESULT>
</ITEM>
Show FTP-Push-job
[otr]/downloader/api/ftppushs.php
• |
&ftppush_id= |
Optional. Without Parameter all jobs are displayed |
A XML-File with the following structure will be returned:
<ITEM>
<FTPPUSH_ID></FTPPUSH_ID>
<FILENAME></FILENAME>
<HOST></HOST>
<MESSAGE></MESSAGE>
<ADDED></ADDED>
<ADDED_NICE></ADDED_NICE>
<LASTTRY></LASTTRY>
<LASTTRY_NICE></LASTTRY_NICE>
<RETRIES></RETRIES>
<DELETELINK></DELETELINK>
</ITEM>
Show most wanted shows for the future
[otr]/rss/highlights_germany.xml
[otr]/rss/highlights_usa.xml
[otr]/rss/toprecordings_germany.xml
[otr]/rss/toprecordings_usa.xml
A XML-File with the following structure will be returned:
<ITEM>
<EPGID></EPGID>
<BEGIN></BEGIN>
<NICEBEGIN></NICEBEGIN>
<END></END>
<NICEEND></NICEEND>
<STATION></STATION>
<TITLE></TITLE>
</ITEM>
If a request is missing, please define/specify a new request and ask for realization at otrsupport@googlemail.com