Changes were applied today that were announced a while back in Y.A.N.F: Private Message XML Ticker.

Due to popular demand the plans were changed slightly so that hopefully the impact on unchanged clients will be lower. The behaviour is as follows:

http://perlmonks.org/index.pl?node_id=15848

max_recs=N
Sets the maximum number of records to return. Hard limits are imposed and are subject to change.
since_id=MSG_ID
Returns nodes later than MSG_ID
prior_to=MSG_ID
Returns nodes prior to this MSG_ID
neither since_id nor prior_to arguments provided
Returns the users 20 most recent messages.
archived=TYPE
If TYPE is 'both' returns both archived and unarchived messages in one go, if omitted, false or 'no' then return only private messages. If any other true value then returns only archived.
xmlstyle=clean
If present then no newlines are added to the messages.
Records are always returned ordered by ascending message_id.

This should allow people to set up clients fairly easily. First fetch with no arguments, then for new material use since_id=MAX_ID and for older stuff use prior_to=MIN_ID. Repeat until you get no records back (or less than max_recs) then the process is finished. Older clients shouldn't break as they will still get the most recent messages, but not all of them every time.


---
demerphq

    First they ignore you, then they laugh at you, then they fight you, then you win.
    -- Gandhi

• Update:  
Minor fixes. Thanks castaway.


In reply to Y.A.N.F: Private Message XML Ticker (Changes Applied) by demerphq

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.