APIv2 Char KillLog XML

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

Contents

/char/KillLog.xml.aspx

Overview

Returns a list of kills where this character received the final blow and losses of this character. For characters, returns the most recent 25, for corporations, the most recent 100. You can scroll back with the beforeKillID parameter listed below.

Data Caching

This method is cached according to the Long Cache Style.

Input Arguments

Name Type Description
apiKey char(64) Full access API key of account.
beforeKillID int Optional; if present, return the most recent kills before the specified killID.
characterID int The character you are requesting data for.
userID int userID of account for authentication.

Output XML 

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2010-06-17 18:15:01</currentTime>
  <result>
    <rowset name="kills" key="killID" columns="killID,solarSystemID,killTime,moonID">
      <row killID="63" solarSystemID="30000848" killTime="2007-11-15 15:36:00" moonID="0">
        <victim characterID="150340823" characterName="Dieinafire" corporationID="1000169"
                corporationName="Center for Advanced Studies" allianceID="0"
                allianceName="" factionID="0" factionName=""
                damageTaken="6378" shipTypeID="12003" />
        <rowset name="attackers" columns="characterID,characterName,corporationID,corporationName,allianceID,allianceName,
                factionID,factionName,securityStatus,damageDone,finalBlow,weaponTypeID,shipTypeID">
          <row characterID="0" characterName="" corporationID="1000127" corporationName="Guristas"
               allianceID="0" allianceName="" factionID="0" factionName="" securityStatus="0" 
               damageDone="6313" finalBlow="1" weaponTypeID="0" shipTypeID="203" />
          <row characterID="0" characterName="" corporationID="150279367" corporationName="Starbase Anchoring Corp"
               allianceID="0" allianceName="" securityStatus="0" damageDone="65" finalBlow="0"
               weaponTypeID="0" shipTypeID="16632" />
        </rowset>
        <rowset name="items" columns="typeID,flag,qtyDropped,qtyDestroyed,singleton" />
      </row>
      <row killID="62" solarSystemID="30000848" killTime="2007-11-15 14:48:00" moonID="0">
        <victim characterID="150340823" characterName="Dieinafire" corporationID="1000169"
                corporationName="Center for Advanced Studies" allianceID="0"
                allianceName="" factionID="0" factionName=""
                damageTaken="455" shipTypeID="606" />
        <rowset name="attackers" columns="characterID,characterName,corporationID,corporationName,allianceID,allianceName,
                factionID,factionName,securityStatus,damageDone,finalBlow,weaponTypeID,shipTypeID">
          <row characterID="0" characterName="" corporationID="1000127" corporationName="Guristas"
               allianceID="0" allianceName="" factionID="0" factionName="" securityStatus="0" 
               damageDone="394" finalBlow="1" weaponTypeID="0" shipTypeID="23328" />
          <row characterID="150131146" characterName="Mark Player" corporationID="150147571"
               corporationName="Peanut Butter Jelly Time" allianceID="150148475"
               allianceName="Margaritaville" securityStatus="0.3" damageDone="0"
               finalBlow="0" weaponTypeID="25715" shipTypeID="24698" />
        </rowset>
        <rowset name="items" columns="typeID,flag,qtyDropped,qtyDestroyed,singleton">
          <row typeID="3520" flag="0" qtyDropped="3" qtyDestroyed="1" singleton="0" />
          <row typeID="12076" flag="0" qtyDropped="0" qtyDestroyed="1" singleton="0">
            <rowset name="items" columns="typeID,flag,qtyDropped,qtyDestroyed,singleton">
              <row typeID="12259" flag="0" qtyDropped="0" qtyDestroyed="1" singleton="0" />
              <row typeID="1236" flag="0" qtyDropped="2" qtyDestroyed="1" singleton="0" />
              <row typeID="2032" flag="0" qtyDropped="1" qtyDestroyed="1" singleton="0" />
            </rowset>
          </row>
          <row typeID="12814" flag="0" qtyDropped="1" qtyDestroyed="3" singleton="0" />
          <row typeID="2364" flag="0" qtyDropped="0" qtyDestroyed="3" singleton="0" />
          <row typeID="26070" flag="0" qtyDropped="0" qtyDestroyed="2" singleton="0" />
          <row typeID="2605" flag="0" qtyDropped="1" qtyDestroyed="0" singleton="0" />
        </rowset>
      </row>
    </rowset>
  </result>
  <cachedUntil>2010-06-17 19:15:01</cachedUntil>
</eveapi>
 

Output Rowset Columns

Please note, kill information is captured at the time of the kill. This means that if someone appears on a kill and tomorrow changes corporations, the kill will still show that person as belonging to the old corporation. This prevents data from skewing over time.

kills Rowset

Name Type Description
killID int Unique kill ID for this kill. This is to be used as the input for beforeKillID if you need to scroll back. This is globally unique and can be used for uniquely identifying a kill to other killboards.
solarSystemID int The ID of the solar system this kill occurred in.
killTime datetime What time the event occurred.
moonID int In some situations, this is present to define what moon a kill occurred at. Note that this is generally only present in situations where the loss is a POS structure. It is not guaranteed to be populated.

victim Row

Name Type Description
allianceID int If not 0, this is the ID of the alliance the corporation belongs to.
allianceName varchar The name of the above alliance.
characterID int Character's ID. Fairly self-explanatory. Can be 0 in which case this kill was not done by a character and instead was done by a corporation. In the victim case, this implies it is a structure loss.
characterName varchar If present, the name of the above characterID.
corporationID int The ID of the corporation. This will always be present, as there is always a corporation behind the victim, whether it is the corporation itself or simply someone in that corporation.
corporationName varchar The name of the above corporation.
damageTaken int How much damage the victim took before succumbing to fiery defeat and humiliation. Please note that this damage is calculated after resists. It does give you a decent idea of how much they were tanking, however.
factionID int If not 0, this is the ID of the faction the corporation belongs to.
factionName varchar The name of the above faction.
shipTypeID int The item lost. This could be a ship as suggested by the name but can potentially be anything that generates a kill event.

attackers Rowset

Name Type Description
allianceID int If not 0, this is the ID of the alliance the corporation belongs to.
allianceName varchar The name of the above alliance.
characterID int Character's ID. Fairly self-explanatory. Can be 0 in which case this kill was not done by a character and instead was done by a corporation. In the victim case, this implies it is a structure loss.
characterName varchar If present, the name of the above characterID.
corporationID int The ID of the corporation. This will always be present, as there is always a corporation behind the victim, whether it is the corporation itself or simply someone in that corporation.
corporationName varchar The name of the above corporation.
damageDone int The amount of damage this aggressor pumped out before watching in satisfaction as their target lost all structural integrity and exploded. Yeehaw! Again, this is post-resists damage done.
factionID int If not 0, this is the ID of the faction the corporation belongs to.
factionName varchar The name of the above faction.
finalBlow bool Whether or not this aggressor is attributed with the so-called "final blow."
securityStatus float The security status of the aggressor at the time of this kill.
shipTypeID int What ship the attacker was flying. Again, if this attacker is a corporation, this could be something other than a ship. Heck, it might not be a ship anyway, what with the way we tend to report this data.
weaponTypeID int What weapon we decided to show this person as using. Often a weapon, sometimes a ship or missile, rarely a fish.

items Rowset

Please note that items can be nested within other items in the case of containers. Also, for determining what is fitted and what is in cargo and such, use the flags.

Name Type Description
flag byte The flag value of this item, refer to Inventory Flags for more information.
qtyDropped int How many of this item were dropped. If the user had multiple stacks, we compress the total number of dropped items to just one stack for space purposes.
qtyDestroyed int How many of this item fell victim to atomic dispersal and other sad little ends that such things can meet.
typeID short The typeID of this item, references the invTypes table.
singleton int Value is 2 if the item is a blueprint copy, 0 for all other items, including blueprint originals.

Forum References

[1]

Retrieved from "?title=APIv2_Char_KillLog_XML&oldid=6922"
Personal tools