APIv2 Corp StarbaseDetail XML

From EVEDev

Jump to: navigation, search
Image:Api.pngAPI Methods - Category Home - API Libraries - API Usage Examples - API Method Reference - API Page Index

Contents

[edit] /corp/StarbaseDetail.xml.aspx

[edit] Overview

Shows the settings and fuel status of a POS.

[edit] Data Caching

This method is cached according to the short cache style (1 hour).

[edit] Input Arguments

Name Type Description
userID int userID of account for authentication.
apiKey char(64) Full access API key of account.
version (optional) int Version of the API we're calling, needs to be 2.
characterID int CharacterID of character for authentication with Director or CEO access.
itemID int ItemID of the POS as given in the starbase list

[edit] Output XML 

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2010-05-29 20:36:56</currentTime>
  <result>
    <state>4</state>
    <stateTimestamp>2009-05-02 21:31:36</stateTimestamp>
    <onlineTimestamp>2009-04-18 23:30:29</onlineTimestamp>
    <generalSettings>
      <usageFlags>3</usageFlags>
      <deployFlags>0</deployFlags>
      <allowCorporationMembers>1</allowCorporationMembers>
      <allowAllianceMembers>1</allowAllianceMembers>
    </generalSettings>
    <combatSettings>
      <useStandingsFrom ownerID="154683985" />
      <onStandingDrop standing="990" />
      <onStatusDrop enabled="0" standing="0" />
      <onAggression enabled="0" />
      <onCorporationWar enabled="1" />
    </combatSettings>
    <rowset name="fuel" key="typeID" columns="typeID,quantity">
      <row typeID="16275" quantity="2447" />
      <row typeID="16274" quantity="18758" />
      <row typeID="9848" quantity="166" />
      <row typeID="9832" quantity="332" />
      <row typeID="3689" quantity="332" />
      <row typeID="44" quantity="166" />
      <row typeID="16273" quantity="6142" />
      <row typeID="16272" quantity="5644" />
      <row typeID="3683" quantity="1162" />
    </rowset>
  </result>
  <cachedUntil>2010-05-29 21:36:56</cachedUntil>
</eveapi>

[edit] Additional Information

  • When the tower goes into reinforced, stateTimestamp is set to the time that it will come out, to prevent the server from processing the POS until then --Garthagk

[edit] Q&A

  • Is it possible to get powergrid/cpu usage for starbases?
    • Unfortunatly it's not possible to get powergrid/cpu usage for POS, they have to be calculated based on fuel usage between stateTimestamps or prestored in your application. --Garthagk
  • Is it possible to get isOnline attribute (or something similiar) to show whether the starbase is online, reinforced or offline? --Laendra 13:26, 31 August 2007 (CDT)
    • There is a 'state' column so we might get that information according to Garthagk--Exi 22:09, 31 August 2007 (CDT)
  • Is it possible to get starbase configuration listed as a subset of each starbase (e.g. itemID, typeID, isOnline for each starbase module)? --Laendra 13:30, 31 August 2007 (CDT)
    • No, POS structures are handled in the DOGMA server code which is not accessible by the API, Garthagk said those are loaded on server startup into memory and assembled to single POS based on their locations --Exi 22:09, 31 August 2007 (CDT)
  • Is it possible to get the moonID, or posID (DOGMA?) rather then, or in addition to the locationID on starbase Structures on the corp/assetList?
    • Check the StarbaseList API. It already gives you the moonID (except for unanchored Towers, where it is zero.) --Ana 2008-Feb-12
  • Yes, this moonID, but then on the assetList so we can see what structures are at what moon, rather then in what system.
    • Check above, that is a pretty clear "no" to me. --Ana
  • So CCP doesn't save a moonID for starbase assets then? Surely there must be a way? Keep in mind im only asking for a moonID (wich is pretty static), no state or anything like that.
    • I am quite sure they save anchored structures with x/y/z coordinates, and then build the POSes from towers and their nearby modules. And there will be a number of reasons why they probably do not want to export the x/y/z coordinates for the structures... for example you could then locate containers anchored at random 14au+ savespots, which right now you have no way to do ingame, and the API really should not expose anything that is not available ingame. Just a guess of cause :) --Ana
  • Is it possible to get a *dataTime* parameter in the output? It is not clear to me the date of the data snapshot for the POS detail. Most likely seems to be the cached-until time minus 6 hours or so.
    • solved by the recent changes to cachetime and the addition of the new data fields --Ana

[edit] Notes

Returns API error 209 'Character must be a Director or CEO.' for character in NPC corporation.

Retrieved from "http://wiki.eve-id.net/APIv2_Corp_StarbaseDetail_XML"
Personal tools