StarbaseDetail

Returns details for specified starbase.

  • Path: /corp/StarbaseDetail.xml.aspx

  • Access mask: 131072

  • Cache timer: 1 hour

  • Parameters:

    Argument Type Meaning
    keyID long API key ID
    vCode char API verification code
    itemID long ItemID of the POS as given in the starbase list

Sample Response

<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>

ResultData

Name Data type Description
state int Current POS state. See known POS states.
stateTimestamp datetime Depend on current POS stete. See known POS states.
onlineTimestamp datetime When the POS will be online or most recently was put online. See known POS states.
generalSettings
usageFlags int Access restrictions to the POS fuel bay are encoded in this 4 bit field. See flags description.
deployFlags int Access restrictions to who is able to operate this POS are encoded in this 8 bit field. See flags description.
allowCorporationMembers int POS Usage restriction for corporation members. 1- allowed, 0 - not allowed.
allowAllianceMembers int POS Usage restriction for alliance members. 1- allowed, 0 - not allowed.
combatSettings
useStandingsFrom Represents POS "Use alliance standings" settings.
ownerID long ID of standings holder - corporation or alliance.
onStandingDrop Represents POS "Attack if standings lower than" settings.
standing int Standing below that POS will attack targets.
onStatusDrop Represents POS "Attack if security status lower than" and "Attack if other security status is dropping" settings.
standing int Represents POS "Attack if security status lower than" settings.
enabled int "Attack if other security status is dropping" 1 = enabled, 0 = disabled
onAggression Represents POS "Attack if agression" setting
enabled int 1 = enabled, 0 = disabled
onCorporationWar Represents POS "Attack if at war" settings
enabled int 1 = enabled, 0 = disabled
rowset fuel
typeID long typeID of fuel that presents in POS fuel bay or strontium bay
quantity int quantity of specified fuel type in POS fuel bay or strontium bay

Flags Description

  • How it works: There are two flags - the usage flag and the deploy flag. Each flags contain the information about which roles can perform which activity for the POS. That information is encoded in a 4 bit (usage) or 8 bit (deploy) field. A role is encoded in 2 bits, so each flag is divided into sections of 2 bits. Each of that sections correspond with a role.
  • Roles: The role needed to get access to a POS facilities is encoded in 2 bits:
  • 00 'Starbase Config'
  • 01 'Corporation Members'
  • 10 'Alliance Members'
  • 11 'Starbase Fuel Tech'

  • Usage Flags: Access restrictions to the POS fuel bay are encoded in this 4 bit field.

    Bits Role
    0, 1 view
    2, 3 take

Example:

usage field = 3 decimal => 0011 binary

bits 0,1 = 11 => Starbase Fuel Tech can view

bits 2,3 = 00 => Starbase Config can take

  • Deploy Flags: Access restrictions to who is able to change state of this POS are encoded in this 8 bit field.
Bits Role
0, 1 anchor
2, 3 unanchor
4, 5 online
6, 7 offline

Example:

deploy field = 99 decimal => 01100011 binary

bits 0,1 = 11 => Starbase Fuel Tech can anchor

bits 2,3 = 00 => Starbase Config can unanchor

bits 4,5 = 10 => Alliance Members can online

bits 6,7 = 01 => Corporation Members can offline