 | | |
|
| Explanation of the all-users XML data feed | |
This is what a single userid item looks like:
<userid>
<id>0verthemoon</id>
<displayname>0verthemoon (USA: CA)</displayname>
<active>1</active>
<country>US</country>
<feedback_score>3</feedback_score>
<lastnow>1169751223</lastnow>
<librarything_user>checked</librarything_user>
<now>1165372956</now>
<points>22</points>
<sequence>3</sequence>
<willsend>askme</willsend>
<zip>94025</zip>
<asins_listed>
<asins_listed_item>
<id>0451459156</id>
<now>1165373287</now>
<condition>inscription on inside cover, like new other than that...</condition>
</asins_listed_item>
</asins_listed>
<feedback>
<feedback_item>
<id>ttandjj/8</id>
<now>1167872487</now>
<feedback_score>1</feedback_score>
<asin>0345442636</asin>
<transactionid>ttandjj/8</transactionid>
<feedback_comment>Great condition, evenything was perfect. Thanks again.</feedback_comment>
<userid_from>ttandjj</userid_from>
<giver_comment>Please read description next time. I describe books online for a living and have never had a problem</giver_comment>
<giver_comment_now>1161181035</giver_comment_now>
</feedback_item>
</feedback>
<history_given>
<history_given_item>
<id>peixao/4</id>
<receiver_country>US</receiver_country>
<receiver_comments></receiver_comments>
<points_to_giver>10</points_to_giver>
<points_from_receiver>10</points_from_receiver>
<asin>0609605453</asin>
<status>received</status>
<now>1167872702</now>
<closedate>1168654886</closedate>
<giver>0verthemoon</giver>
<receiver>peixao</receiver>
<date_sent>1168111003</date_sent>
</history_given_item>
</history_given>
<history_received>
<history_received_item>
<id>0verthemoon/1</id>
<receiver_country>US</receiver_country>
<receiver_comments>thanks!</receiver_comments>
<points_to_giver>10</points_to_giver>
<points_from_receiver>10</points_from_receiver>
<condition>The spine is a bit creased but otherwise is in good used book condition.</condition>
<asin>006088231X</asin>
<closedate>1166232418</closedate>
<status>received</status>
<now>1165616533</now>
<giver>kd5fto</giver>
<receiver>0verthemoon</receiver>
<date_sent>1165849974</date_sent>
</history_received_item>
</history_received>
<wishlist>
<wishlist_item>
<id>0765309300</id>
<now>1169743168</now>
</wishlist_item>
</wishlist>
<pointslog>
<pointslog_item>
<description>added book to inventory</description>
<now>1169750867</now>
<oldpoints>12</oldpoints>
<points>1</points>
<active_user>0verthemoon</active_user>
<transaction></transaction>
<asin>1596060638</asin>
<newpoints>13</newpoints>
</pointslog_item>
</pointslog>
<pending_give>
<item>theveryidea/111</item>
</pending_give>
<pending_receive>
<item>0verthemoon/3</item>
</pending_receive>
<searchlog>
<item>jim butcher</item>
<item>charles stross</item>
</searchlog>
</userid>
Here is a version of the same record, but with an explanation in place of the field data:
<userid>
<id>user id of the BookMooch user</id>
<displayname>Display name of this user</displayname>
<active>whether or not this user is active. 1=active, 0=not active (ie, disabled account)</active>
<country>the country the user resides in</country>
<feedback_score>cahed total sum of their feedback. This is updated automatically any time this user's
feedback is added or changed, and should equal a calculated sum of the user's feedback
received.</feedback_score>
<lastnow>time stamp of their last log in. Multiple logins within a 1h period are not updated
(ie, this is accurate to within 1 hour)</lastnow>
<librarything_user>Whether this user has enabled the LibraryThing integration. Blank=no, any
value=yes</librarything_user>
<now>time stamp for when this user account was first created</now>
<points>total number of points this user has, in x10 notation (ie, 20 = 2 points)</points>
<sequence>the ID for this user's next mooch (ie, the next mooch would be given an ID of
"username/sequence"</sequence>
<willsend>Where in the world this user has indicated they will send books to. askme=domestic yes,
international by request, mycountry=only their country, anywhere=worldwide</willsend>
<zip>the person's postal code</zip>
<asins_listed>
<asins_listed_item>
<id>ASIN of the book this person is offering to give away (ie, it is in their
inventory) </id>
<now>time-stamp when this book was added to their inventory</now>
<condition>condition notes for this person's copy of this book</condition>
</asins_listed_item>
</asins_listed>
<feedback>
<feedback_item>
<id>ID of this feedback item. Usually the same as the transactionid</id>
<now>time-stamp when this feedback item was first created</now>
<feedback_score>score given to this feedback item, may be 1, 0 or -1</feedback_score>
<asin>the ASIN of the book this feedback refers to</asin>
<transactionid>transaction ID this feedback item refers to. May refer to an active
transaction in the pending table, or a historical transaction in a user's
history_given</transactionid>
<feedback_comment>textual comment.</feedback_comment>
<userid_from>the userid of the author of this feedback item</userid_from>
<giver_comment>Optional textual comment left by the book giver (ie, usually a
rebuttal to negative feedback)</giver_comment>
<giver_comment_now>time-stamp for when the book giver comment was left</giver_comment_now>
</feedback_item>
</feedback>
<history_given>
<history_given_item>
<id>Transaction ID of this completed book swap (mooch) transaction, for books this userid
has given away</id>
<receiver_country>the country the book receiver resides in</receiver_country>
<receiver_comments>any comment the book receiver leaves</receiver_comments>
<points_to_giver>the number of points (x10 format) that were awarded to the book
giver for sending this book</points_to_giver>
<points_from_receiver>the number of points (x10 format) that were taken away from
the book moocher to receive this book</points_from_receiver>
<asin>the ASIN of the book that this transaction refers to</asin>
<status>the final status of this completed transaction. See pending
for an explanation of the various status codes.</status>
<now>the time stamp for when this transaction was first created</now>
<closedate>the time stamp for when this transaction was closed (ie, it was
moved from the pending table to the user's history)</closedate>
<giver>the user id of the person giving this book away</giver>
<receiver>the user id of the person receiving this book</receiver>
<date_sent>time-stamp of when this book was sent</date_sent>
</history_given_item>
</history_given>
<history_received>
<history_received_item>
<id>Transaction ID of this completed book swap (mooch) transaction, for books this userid
has received</id>
<receiver_country>the country the book receiver resides in</receiver_country>
<receiver_comments>any comment the book receiver leaves</receiver_comments>
<points_to_giver>the number of points (x10 format) that were awarded to the book
giver for sending this book</points_to_giver>
<points_from_receiver>the number of points (x10 format) that were taken away from
the book moocher to receive this book</points_from_receiver>
<asin>the ASIN of the book that this transaction refers to</asin>
<status>the final status of this completed transaction. See pending
for an explanation of the various status codes.</status>
<now>the time stamp for when this transaction was first created</now>
<closedate>the time stamp for when this transaction was closed (ie, it was moved from
the pending table to the user's history)</closedate>
<giver>the user id of the person giving this book away</giver>
<receiver>the user id of the person receiving this book</receiver>
<date_sent>time-stamp of when this book was sent</date_sent>
</history_received_item>
</history_received>
<wishlist>
<wishlist_item>
<id>The ASIN of a book on this person's wishlist</id>
<now>time-stamp when this book was added to this person's wishlist</now>
</wishlist_item>
</wishlist>
<pointslog>
<pointslog_item>
<description>a descrption of this point change event. Any event that causes a point
change for a member is logged here. This log serves only for auditing points, it is
not used in calculating points.</description>
<now>time-stamp of when this point change event took place</now>
<oldpoints>the number of points (in x10 format) before this point change even
took place</oldpoints>
<points>the number of points being added or subtracted from oldpoints (in x10 format).
Can be a negative number</points>
<active_user>the userid of the person currently logged in causing this point
change event</active_user>
<transaction>if this point change was caused by a mooch, this is the transaction
ID of that mooch transaction</transaction>
<asin>if this point change was caused by a mooch, this is the ASIN of the book
referred to in the mooch transaction</asin>
<newpoints>the number of points the user now has (ie oldpoints + points = newpoints)
</newpoints>
</pointslog_item>
</pointslog>
<pending_give>
<item>transaction ID of any mooch transaction by this person, giving books away</item>
</pending_give>
<pending_receive>
<item>transaction ID of any mooch transaction by this person, receiving books</item>
</pending_receive>
<searchlog>
<item>text of any full text searches this user has made for books (via "browse" or the full
search feature on the top right of the BookMooch web pages)</item>
</searchlog>
</userid>
| | | |
