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.
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.
|
