APIv2 Char NotificationTexts XML

From EVEDev

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

Contents 1 /char/NotificationTexts.xml.aspx 1.1 Overview 1.2 Data Caching 1.3 Input Arguments 1.4 Output XML 1.5 Possible Output XML 1.6 Output Details 1.6.1 69 - Agent locates a character

[edit] /char/NotificationTexts.xml.aspx

[edit] Overview

Returns the message bodies for notifications. Headers need to be requested via /char/Notifications.xml.aspx first.

[edit] Data Caching

This method is cached according to the Modified Short Cache Style.

[edit] Input Arguments

Name	Type	Description
apiKey	char(64)	Full access API key of account.
userID	int	userID of account for authentication.
characterID	int	The ID of the character for the requested data, from Character List.
IDs	string	comma separated list of notificationIDs obtained via the /char/Notifications.xml.aspx API call.

[edit] Output XML

<?xml version="1.0" encoding="UTF-8" ?> 
<eveapi version="2">
  <currentTime>2012-04-12 00:52:31</currentTime>
  <result>
    <rowset name="notifications" key="notificationID" columns="notificationID">
      <row notificationID="374044083">isHouseWarmingGift: 1
        shipTypeID: 606
      </row>
      <row notificationID="374067406">amount: 25000000
        dueDate: 129808158000000000
      </row>
      <row notificationID="374106507">againstID: 673381830
         cost: null
         declaredByID: 98105019
         delayHours: null
         hostileState: null
      </row>
      <row notificationID="374119034">aggressorAllianceID: 673381830
          aggressorCorpID: 785714366
          aggressorID: 1746208390
          armorValue: 1.0
          hullValue: 1.0
          moonID: 40264916
          shieldValue: 0.995
          solarSystemID: 30004181
          typeID: 16688
      </row>
      <row notificationID="374133265">amount: 5125528.4
          itemID: 1005888572647
          payout: 1
      </row>
    </rowset>
    <cachedUntil>2021-01-19 13:24:07</cachedUntil>
  </result>
</eveapi>

[edit] Possible Output XML

<?xml version="1.0" encoding="UTF-8" ?> 
<eveapi version="2">
  <currentTime>2011-01-22 13:24:07</currentTime> 
  <result>
    <rowset name="messages" key="messageID" columns="messageID" /> 
    <missingIDs>331337318</missingIDs> 
  </result>
  <cachedUntil>2021-01-19 13:24:07</cachedUntil> 
</eveapi>

[edit] Output Details

Depending on the type of the notification there is structured data available in the notification.

[edit] 69 - Agent locates a character

Section	Name	Description
agentLocation	3	Region of the locator agent
	4	Constellation of the locator agent
	5	Solarsystem of the locator agent
	15	Station of the agent
	x/y/z	Coordinates of the locator agent
characterID		characterID of the target
messageIndex
targetLocation	3	Region of the target
	4	Constellation of the target
	5	Solarsystem of the target
	6	Shipname of the target
	15	Station of the target
	x/y/z	Coordinates of the target (if not in station)