It returns an array of objects (or an XML doc, depending on your method of access) with the following properties for each direct message:
- messsageID: ID of the message.
- senderUserName: User name of user who sent the message.
- senderUserId: User ID of the user who sent the message.
- senderProfileImageName: Name of the user's profile image (untested with users without image names -- don't rely heavily on this, I might remove it.)
- message: The actual text of the direct message.
- sent: When the message was sent (may be in the "X minutes ago" format or a timestamp depending on how it is returned by Twitter.)
Usage instructions:
JSON
http://aralbalkan.com/twitapi/json.php/Twitter.getDirectMessages/userName/passWord
XML
http://aralbalkan.com/twitapi/get_direct_messages_xml.php?user=userName&pass=passWord
Flash Remoting
Check out the AMFPHP service browser.
The A new method for TwitAPI: getDirectMessages article by Aral Balkan, unless otherwise expressly stated, is licensed under a Creative Commons Attribution-Noncommercial 2.0 UK: England License.
The API seems to have broken, either that or no one has any friends anymore.
I played around with an XSLT to parse out the friends list, except when I ran it with the W3C XSLT service it broke. Turns out that if you’re not logged in to twitter, it doesn’t write out an opening tag in its header, but does write the closing tag, totally screwing up the dom!