APIv2 Char Research XML

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

Contents

/char/Research.xml.aspx

Overview

Returns information about agents character is doing research with.

Data Caching

This method is cached according to the Short Cache Style.

Input Arguments

Name Type Description
apiKey char(64) Full access API key of account. (CCP is talking about changing this to Limited key instead but for now it still requires full)
characterID int CharacterID of character for authentication.
userID int userID of account for authentication.


Output XML

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2010-01-22 22:02:46</currentTime>
  <result>
    <rowset name="research" key="agentID" columns="agentID,skillTypeID,researchStartDate,pointsPerDay,remainderPoints">
      <row agentID="3011113" skillTypeID="11452" researchStartDate="2009-09-08 06:19:29" pointsPerDay="66.64" remainderPoints="6.293213773155" />
      <row agentID="3011154" skillTypeID="11452" researchStartDate="2009-09-02 06:49:35" pointsPerDay="65.66" remainderPoints="33.0962187499972" />
      <row agentID="3011165" skillTypeID="11452" researchStartDate="2007-10-19 22:18:37" pointsPerDay="68.48" remainderPoints="-29285.7593840278" />
      <row agentID="3011534" skillTypeID="11453" researchStartDate="2009-09-08 06:36:20" pointsPerDay="85.76" remainderPoints="31.7952812500007" />
    </rowset>
  </result>
  <cachedUntil>2010-01-22 22:17:46</cachedUntil>
</eveapi>
 

Output Rowset Columns

Name Type Description
agentID int The agent ID number.
skillTypeID int The skill used for the research, not the typeID of the core received.
researchStartDate date string The date the character began the current research with the agent at the current pointsPerDay. Each change in pointsPerDay will update researchStartDate as well.
pointsPerDay decimal The number of points generated per day.
remainderPoints float The number of points remaining since last datacore purchase and/or pointsPerDay update. Mission RP is also added to this value.

Notes

Notice that remainderPoints will be a negative number if you've bought datacores from agent.

Formula for finding current RP you have is: currentPoints = remainderPoints + pointsPerDay * <Difference between now and startdate>

Personal tools