APIv2 Char MailBodies XML

From EVEDev

API Methods - Category Home - API Overview - API Page Index - API Libraries - API Wanted Features

1 /char/MailBodies.xml.aspx

[edit] /char/MailBodies.xml.aspx

[edit] Overview

This API call is available on TQ since Tyrannis 1.2.

Returns the bodies of headers that have already been fetched with the MailMessages call. It will also return a list of missing IDs that could not be accessed. Bodies cannot be accessed if you have not called for their headers recently.

[edit] Data Caching

This method is ostensibly cached according to the Modified Short Cache Style. However, as soon as new messages are returned via the MailMessages call their bodies can also be accessed via this call regardless of the cache interval.

[edit] Input Arguments

Name	Type	Description
userID	int	userID of account for authentication.
characterID	int	characterID from Character List.
apiKey	char(64)	Full access API key of account.
ids	string	comma separated list of messageIDs from MailMessages

[edit] Output XML

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2010-10-05 21:31:58</currentTime>
  <result>
    <rowset name="messages" key="messageID" columns="messageID">
      <row messageID="297023723"><![CDATA[Hi.<br><br>This is a message.<br><br>]]></row>
      <row messageID="297023208"><![CDATA[<p>Another message</p>]]></row>
    </rowset>
    <missingMessageIDs>297023210,297023211</missingMessageIDs>
  </result>
  <cachedUntil>2020-10-02 21:31:58</cachedUntil>
</eveapi>

[edit] Possible Output XML

<?xml version="1.0" encoding="UTF-8" ?> 
<eveapi version="2">
  <currentTime>2010-10-05 21:31:58</currentTime> 
  <result>
    <rowset name="messages" key="messageID" columns="messageID" /> 
    <missingMessageIDs>297023723</missingMessageIDs> 
  </result>
  <cachedUntil>2020-10-02 21:31:58</cachedUntil> 
</eveapi>