Free the mouse Replay RnsGetPutXact
Home | Changes | Index | Search | Go

getxact.pl and putxact.pl requests

These requests are used to synchronize with MyReplayTV; presumably they aren't made if MyReplayTV isnt't enabled, but that hasn't been verified.

getxact.pl

This request looks like:
   http://rns.replaytv.net/cgi-bin/2.0/getxact.pl?serial=RTV4080K1AA5000149&tid=237249

The tid argument is the transaction ID of the last-seen transaction; it's omitted entirely if there have been no previously received transactions.

The response body has content-type application/vnd.replay.transaction. It's a mixed binary/text format; it's a sequence of transaction records, each of which has a 32-byte binary header and a variable-length XML body.

A sample record looks like:

00000000 00 00 00 00 00 03 9e c1 00 00 00 00 00 00 00 00   ................
00000010 00 00 00 78 00 00 00 00 00 01 a9 82 00 00 00 00   ...x............
00000020 3c 72 65 71 75 65 73 74 20 72 65 71 49 44 3d 22   <request reqID="
00000030 32 33 37 32 34 39 22 20 72 65 71 4e 61 6d 65 3d   237249" reqName=
00000040 22 52 65 6d 6f 76 65 52 65 70 6c 61 79 53 68 6f   "RemoveReplaySho
00000050 77 22 3e 20 0a 20 20 3c 70 61 72 61 6d 73 20 63   w"> .  <params c
00000060 68 61 6e 6e 65 6c 49 44 3d 22 31 30 31 34 38 38   hannelID="101488
00000070 35 32 30 33 22 20 73 68 6f 77 49 44 3d 22 31 30   5203" showID="10
00000080 31 35 38 39 38 33 39 37 22 20 2f 3e 0a 3c 2f 72   15898397" />.</r
00000090 65 71 75 65 73 74 3e 0a                           equest>.

Record Header

offset size name Description
0 4 prev_tid transaction ID of last-synchronized transaction (guess), or 0
4 4 tid Transaction ID for this transaction, or 0
8 8 unknown all zeros
16 4 bodysize the length of the record body
20 4 unknown all zeros
24 2 type 1 in all my samples
26 2 magic must be 0xa982
28 4 unknown all zeros

Record Bodies

Six sample record bodies:
<request reqID="237249" reqName="RemoveReplayShow"> 
  <params channelID="1014885203" showID="1015898397" />
</request>

<request reqID="237250" reqName="AddReplayChannelShow"> 
  <params headendID="OR36575" TMSID="19211" inputSource="REPLAYTV" device="X" tuning="0" startTimeGMT="2002-03-17 21:30:00.0" durationInMinutes="30" quality="STANDARD" isManualRecording="false" guaranteedRecord="true" recordAllEpisodes="false" numEpisodes="1" weekdayFlags="127" showGuardMinutes="0" earlyStartMinutes="0" />
</request>

<request reqID="237251" reqName="AddReplayChannelTheme"> 
  <params searchTerm="vanessa" searchFlags="20" suzukiID="0" durationInMinutes="120" quality="STANDARD" guaranteedRecord="true" />
</request>

<request reqID="237252" reqName="UpdateReplayChannelTheme"> 
  <params channelID="1014885203" searchTerm="vanessa" searchFlags="20" suzukiID="0" durationInMinutes="120" quality="STANDARD" guaranteedRecord="true" />
</request>

<request reqID="237253" reqName="RemoveReplayChannel"> 
  <params channelID="1014885203" />
</request>

<request reqID="237254" reqName="PreserveReplayShow"> 
  <params channelID="1014885203" showID="1015898397" />
</request>

Unverified additional sample record bodies:
<request reqID="237250" reqName="UpdateReplayChannelShow"> 
  <params channelID="1014885203" headendID="OR36575" TMSID="19211" inputSource="REPLAYTV" device="X" tuning="0" startTimeGMT="2002-03-17 21:30:00.0" durationInMinutes="30" quality="STANDARD" isManualRecording="false" guaranteedRecord="true" recordAllEpisodes="false" numEpisodes="1" weekdayFlags="127" showGuardMinutes="0" earlyStartMinutes="0" />
</request>

putxact.pl

This request is a POST request, that looks like:
   http://rns.replaytv.net/cgi-bin/2.0/putxact.pl?serial=RTV4080K1AA5000149

The body of the POST is also type vnd.replay.transaction, and as such it matches the overall format given above.

Sample record bodies (shortened, but hopelly still valid):

<result reqID="0" reqName="GetChannelLineup" >
  <channel-list>
    <channel index="120" headendID="OR36575" TMSID="19211" device="X" tuning="120" channelName="NOGGIN" inputSource="LINE1" />
    <channel index="121" headendID="OR36575" TMSID="16618" device="X" tuning="121" channelName="DCKIDS" inputSource="LINE1" />
  </channel-list>
  <params success="TRUE" errorCode="0" timeStamp="2002-03-17 07:15:15.640" />
</result>

<result reqID="237249" reqName="RemoveReplayShow" >
  <params success="TRUE" errorCode="0" timeStamp="2002-03-17 07:15:12.265" />
</result>

<result reqID="0" reqName="GetUnitInfo" >
  <params success="TRUE" errorCode="0" timeStamp="2002-03-17 07:15:12.565" totalSize="158943674368" guaranteedSpace="83776037184" spaceAvailable="139347099648" buildVersion="520411140" quality="STANDARD" numEpisodes="3" country="US" phoneNumber="" postalCode="97206" timeZone="PST8PDT" local="" />
</result>

<result reqID="0" reqName="GetReplayGuide" >
  <channel-list>
    <channel channelID="1014884949" name="Buffy the Vampire Slayer" quality="STANDARD" guaranteedRecord="TRUE" weekdayFlags="127" showGuardMinutes="0" earlyStartMinutes="0" type="SHOW" index="1053" headendID="OR36575" TMSID="14753" device="@" tuning="53" channelName="FXP" inputSource="REPLAYTV" startTimeGMT="2002-02-28 15:00:00.000" durationInMinutes="60" recordAllEpisodes="TRUE" numEpisodes="10" isManualRecording="FALSE" title="Buffy the Vampire Slayer" description="A new gang of vampires targets Buffy." episodeTitle="Real Me">
    </channel>
  </channel-list>
  <params success="TRUE" errorCode="0" timeStamp="2002-03-17 07:15:14.525" />
</result>


-- Main.ToddLarason - 16 Mar 2002 (Update by HenryDonzis 10 Dec 2009)




Your post will appear before this form in chronological order (newest at bottom)
<nop>

Topic RnsGetPutXact . { Edit | Attach | Ref-By | Printable | Diffs | r1.2 | > | r1.1 | More }
Revision r1.2 - 01 Apr 2003 - 04:48 GMT - TWikiGuest

Copyright © 2001 by the contributing authors. All material on this collaboration tool is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback.