APIv2 Char MailBodies XML

From EVEDev
Jump to: navigation, search
Api.pngAPI Methods - Category Home - API Overview - API Page Index - API Libraries - API Wanted Features

Contents

/char/MailBodies.xml.aspx

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.

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.

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


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>
 

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>

References

Personal tools