APIv2 Char NotificationTexts XML

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




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

Data Caching

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

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.

Output XML

<?xml version="1.0" encoding="UTF-8" ?> 
<eveapi version="2">
  <currentTime>2012-04-12 00:52:31</currentTime>
    <rowset name="notifications" key="notificationID" columns="notificationID">
      <row notificationID="374044083">isHouseWarmingGift: 1
        shipTypeID: 606
      <row notificationID="374067406">amount: 25000000
        dueDate: 129808158000000000
      <row notificationID="374106507">againstID: 673381830
         cost: null
         declaredByID: 98105019
         delayHours: null
         hostileState: null
      <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 notificationID="374133265">amount: 5125528.4
          itemID: 1005888572647
          payout: 1
    <cachedUntil>2021-01-19 13:24:07</cachedUntil>

Possible Output XML

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

Output Details

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

The time outputed by some of the notifications is formatted to Microsoft's version of epoch time, the formula to convert this to unix epoch is: $x = ($v/10000000)-11644473600; Where $v is the time returned in the notification text.

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
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)
Personal tools