APIv2 Char Research XML
From EVEDev
| API Methods - Category Home - API Overview - API Page Index - API Libraries - API Wanted Features |
Contents |
[edit] /char/Research.xml.aspx
[edit] Overview
Returns information about agents character is doing research with.
[edit] Data Caching
This method is cached according to the Short Cache Style.
[edit] 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.
|
[edit] 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>
[edit] 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. |
[edit] 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>

