|
|
|
XML interface is accessed by going to Personal -> XML Access and generating a full access code. This then creates a <ID> and <Code> that allows you to access the site data via your user details.
The general request to get the XML pages is:
http://www.phoenixbse.com/index.php?a=xml&uid=<ID>&code=<Code>&sa=<request>
The <request> is either:
- info_data - gets current info that you know about
- order_data - gets current order data
- pos_list - gets a list of your positions and locations
- send_orders - sends a set of orders posted as XML
- game_status - gets teh game status
- turn_data&tid=<position number>- gets a self contained HTML turn
- pending_orders&pid=<position number>- gets the pending orders for a turn
- notes - gets the notifications for your account
- items - gets all the items and their data that you know about
- systems - gets all the systems and cbodies that you know about [Adding &system_id=<system number> gives you all the planet data for a system]
- base_data - gets all items in bases + extra info
- scans - gets last 5 days of scans
Notes: [1] turn_data can have a &type=file which makes it return the filename of the html fragment on the site, to download this file use www.phoenixbse.com/?a=tf&t=<returned filename> [2] when turn_data fails it now returns all the possible turns with file names / last update stamps [3] Pending orders returns the pending orders (as seen on the turns) if there is no current queued orders. Otherwise it returns the orders in the current queued turn. If you add type=turn you always get the orders that the off-line game has stacked for you and if you add type=current you only get the current orders that are queued. [4] You sometime will have to call 'scans' multiple times until it has <ready>true</ready> rather than <ready>false</ready> [5] 'systems' data contains all the enenies per system and charters. There is also a <charters> block that contains all relevent charters. |
|
|
|
Notifcations defines
|
[Recruit] |
|
|
NOTE_TURN_DATA => 1 - position_id,system_id,type,squad NOTE_NEW_POSITION => 2 - position_id,system_id,type,squad NOTE_ACTIVE_MISSION => 3 - mission_id,pos_number NOTE_NEW_MISSION => 4 - mission_id NOTE_BATTLE => 5 - location_name,number ships,system_id NOTE_DELIVERY => 6 - position_id,system_id,quant,item_id,deliver_to_id NOTE_PICKUP => 7 - position_id,system_id,quant,item_id,picked_up_from_id NOTE_BUY => 8 - position_id,system_id,quant,item_id,bought_from_id,stellars NOTE_SELL => 9 - position_id,system_id,quant,item_id,sold_to_id,stellars NOTE_TRANSFER_IN => 10 - position_id,stellars NOTE_POSITION_TRANSFER => 11 - position_id,system_id,type,transfer_id NOTE_RELATIONS_CHANGE => 12 - aff_id,status NOTE_SYSTEM_CHARTER => 13 - aff_id,status,charter_id - disabled NOTE_RESTRICTED_STARBASE => 14 - position_id NOTE_RESTRICTED_CBODY => 15 - system_id,cbody_id NOTE_RESTRICTED_SYSTEM_LINK => 16 - system_id NOTE_RESTRICTED_ITEM => 17 - item_id NOTE_RESTRICTED_ORDER => 18 - order_id NOTE_RESTRICTED_MISSION => 19 - mission_id NOTE_RESTRICTED_SYSTEM_LOC => 20 - system_id NOTE_DELIVERED_TO => 21 - position_id,system_id,quant,item_id,by_id NOTE_PICKED_UP_FROM => 22 - position_id,system_id,quant,item_id,by_id NOTE_BOUGHT_FROM => 23 - position_id,system_id,quant,item_id,by_id,stellars NOTE_SOLD_TO => 24 - position_id,system_id,quant,item_id,by_id,stellars NOTE_BOARDED => 25 - loc,system_id,position_id NOTE_RAIDED => 26 - loc,system_id,position_id NOTE_COMBAT_TRANSACTION => 27 - loc,system_id,position_id NOTE_SEL_POSITION => 28 - position_id,amount
//coming soon NOTE_RESTRICTED_DATA => 29 - restricted_type,data0,data1 NOTE_PLANETARY_SALES => 30 - position_id,system_id,cbody_id,trade_type,stellars NOTE_NEXUS_CASH => 31 - position_id,stellars NOTE_GM_NOTE => 32 - position_id,group_id,system_id,cbody_id,subject + msg NOTE_RUMOUR => 33 - data NOTE_SPOTTED => 34 - position_id,system_id,location_name - not done yet NOTE_TURN_ERROR => 35 - position_id,system_id,cbody_id,error_code,txt NOTE_WARNING => 36 - position_id,system_id,cbody_id,warning_code,txt NOTE_RESEARCH_FINISHED => 37 - position_id,item_id NOTE_COMPLEX_VISIT => 38 - position_id,base_id,complex_type (txt) NOTE_TRANSFER_OUT => 39 - to_position_id,stellars NOTE_ORBITAL_DROP => 40 - position_id,system_id,quant,item_id,by_id - like deliver NOTE_ORBITAL_RESUPPLY => 41 - position_id,system_id,quant,item_id,by_id - like deliver to NOTE_SPECIAL_ACTION => 42 - position_id,header + text NOTE_MESSAGE => 43 - src_pos_id,to_pos_id + message NOTE_AGENT_ACTION => 44 - position_id,system_id,action_text + text NOTE_REMINDER => 45 - position_id,note (80 char) + order at add NOTE_COMPLEX_CHANGE => 46 - position_id,complex_type,built/scrapped/activated/deactivated,number NOTE_ACCOUNT_LOW => 47 - cash, account below £10 - not done yet NOTE_REGISTERED_BASE_ACTIVITY => 48 - position_id,system_id,cbody_id,action_type (attacked/bought/registed/deregistered) NOTE_OPPORTUNITY_FIRE => 49 - loc,system_id,position_id + txt NOTE_ESCAPING_COMBAT => 50 - loc,system_id,position_id + txt NOTE_ITEM_DAMAGE => 51 - position_id,item_id,qty,damage,why(optional) NOTE_GATE_PLATFORM_UPDATE => 52 - position_id,system_id,cbody_id,text NOTE_LANDING_LIST => 53 - position_id,system_id,cbody_id,target_id,gate,text NOTE_SYSTEM_RAID => 54 - system_id NOTE_INFRASTRUCTURE => 55 - system_id,cbody_id,text
WARNING_DEEPCORE_STRUCT => 0 'Insufficient structural modules to deep core' WARNING_COMPLEXES_NOT_PRODUCING => 1 'Complexes are not producing' WARNING_SB_EFFICIENCY_LOW => 2 'Base Efficiency has dropped below 100%' WARNING_SB_SECURITY_LOW => 3 'Base security has dropped below 100%' WARNING_SHIP_INTEGRITY_LOW => 4 'Ship integrity is low (<25%)' WARNING_SCOUTED => 5 'Scouted' WARNING_BASE_SUBVERTED => 6 'Base subverted' WARNING_BASE_REGISTRATION_REVOKED => 7 'Registration Revoked' TURN_ERROR_NO_STARGATE_KEY => 0 'has no stargate key' TURN_ERROR_NO_KNOW_BASE => 1 'has no knowledge of base' TURN_ERROR_NO_KNOW_SYSTEM => 2 'has no knowledge of system' TURN_ERROR_NO_KNOW_CBODY => 3 'has no knowledge of celestial body' TURN_ERROR_INCORRECT_SEC => 4 'has incorrect security clearance' TURN_ERROR_NO_THRUST => 5 'does not have enough thrust to take off/land' TURN_ERROR_MAINTENANCE_FAILED => 6 'failed to maintain'
COMPLEX_ACTION_BUILT => 0 'built' COMPLEX_ACTION_SCRAPPED => 1 'scrapped' COMPLEX_ACTION_ACTIVATED => 2 'activated' COMPLEX_ACTION_DEACTIVATED => 3 'deactivated'
REGISTERED_BASE_REGISTERED => 0 'registed' REGISTERED_BASE_DEREGISTERED => 1 'de-registered' REGISTERED_BASE_ATTACKED => 2 'been attacked' REGISTERED_BASE_BOUGHT => 3 'been bought'
COMPLEX_VISIT_RECREATION => 0 'used recreation complexes' COMPLEX_VISIT_REPAIR => 1 'repaired' COMPLEX_VISIT_MAINTENANCE => 2 'maintained' COMPLEX_VISIT_UPGRADE => 3 'upgraded' COMPLEX_VISIT_REFIT => 4 'refitted' TRADETYPE_TRADE => 0 'Trade' TRADETYPE_LIFE => 1 'Life' TRADETYPE_DRUGS => 2 'Drugs'
|
|
|
Flags
|
[Recruit] |
|
|
Order Catagory Flags ==================== RDERFLAG_ANY 0x0 ORDERFLAG_THRUSTMOVE 0x1 ORDERFLAG_MOVEMENT 0x2 ORDERFLAG_TRANSACTION 0x4 ORDERFLAG_STANDINGORDER 0x8 ORDERFLAG_BASIC 0x10 ORDERFLAG_SCAN 0x20 ORDERFLAG_OTHER 0x40 ORDERFLAG_ISSUE 0x80 ORDERFLAG_CREATE 0x100 ORDERFLAG_SQUADRONORDER 0x200 ORDERFLAG_SQUADRONSTANDINGORDER 0x400 ORDERFLAG_TURNTYPE 0x800 ORDERFLAG_BOARDING 0x1000 ORDERFLAG_PLANETARYINTERACTION 0x2000 ORDERFLAG_MACRO 0x4000 ORDERFLAG_COPY 0x8000 ORDERFLAG_FULL 0xfffff
Position Type ============= POSITIONTYPE_NONE 0x00 POSITIONTYPE_GP 0x01 POSITIONTYPE_SHIP 0x02 POSITIONTYPE_STARBASE 0x03 POSITIONTYPE_DEBRIS 0x04 POSITIONTYPE_POLITICAL 0x05 POSITIONTYPE_PLATFORM 0x06 POSITIONTYPE_AGENT 0x07
Position Flags ============== POSFLAG_NONE 0x00 POSFLAG_GP 0x01 POSFLAG_SHIP 0x02 POSFLAG_STARBASE 0x04 POSFLAG_POLITICAL 0x08 POSFLAG_PLATFORM 0x10 POSFLAG_AGENT 0x20 POSFLAG_DEBRIS 0x40
Periphery Names / IDs ===================== Cluster 3 Caliphate 9 Coreward Arm 14 Darkfold 2 Dewiek Home 4 Dewiek Pocket 5 Detinus Republic 6 Flagritz Empire 10 Felini Empire 11 Halo 13 Inner Capellan 1 Inner Empire 8 None 0 Orion Spur 16 Outer Capellan 12 Perfidion Reach 17 Transpiral 15 Twilight 7 |
|
|
Sending Orders
|
[Recruit] |
|
|
For send_orders its currently this bit not convinced about sequencing - need to sort that out. {Need to fix so it accepts XML properly}
<turns> <turn pos_id="Position Number" seq="1 or 0" seq_after="Pos Num to seq after" append="true/false"> <orders> <order id="Order ID" issue_type="Issue Type"> <param>Param 0</param> <param>Param 1</param> </order> </orders> </turn> </turns>
All atrribute in <turn> are optional except "position number" Boolean Params Values are: true / false Turns currently are placed into queue (and can end up with duplicates that delete each other if a turn already exists) By default if a turn is send twice it overwrites the original - if append is set to append="true" then orders are appended to the end of a turn. The XML only echos back what it wrote not the whole turn.
Issue Type Is optional - you do not have to add - if added then it takes following states For ships/gps: 0 => Continue on Error 1 => Stop on Error For bases: 0 => Normal Order 1 => Pre Production Order 2 => Post Production Order 3 => End of Week Order |
|
|
Php i used to send XML
|
[Recruit] |
|
|
<?php
$xmlRequest="<turns> <turn pos_id=\"12345\" seq=\"0\" seq_after=\"0\"> <orders> <order id=\"2040\"> <param>1</param> <param>2</param> <param>3</param> <param>True</param> <param>True</param> </order> </orders> </turn> </turns> "; // code is not from live version  $url='127.0.0.1/ss_forums/index.php?a=xml&uid=120&code=c56ec78c26e9c6f136a42a12172fd282&sa=send_orders'; $headers = array( "Content-type: text/xml;charset=\"utf-8\"", "Accept: text/xml", "Cache-Control: no-cache", "Pragma: no-cache" );
try{ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, 1);
// send xml request to a server
curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xmlRequest); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_VERBOSE, 0); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $data = curl_exec($ch);
//convert the XML result into array if($data === false) { $error = curl_error($ch); echo $error; die('error occured'); } else { print_R($data);
} curl_close($ch);
}catch(Exception $e){ echo 'Message: ' .$e->getMessage();die("Error"); } ?>
|
|
|
|
|
|
|
PayPal.Me/creditKJCaccount Don't forget to include your account number in the message. |
|
|

*** Inter Galactic News *** HEF fleet mobilised in the Periphery over exclusion zones; travellers advised to clear enemy lists. Slann (OLD/Aquaphids) arrived unexpectedly, seeking talks on worlds, ecologies, and migrations while staying neutral and modest in force. BHD notes rising miracle claims, including sanctuary visions and a dockside sacrifice that diverted a freighter and may lead to sainthood.OLD refused FLZ demands to leave Shiva (citing AFT-FLZ fighting risk) and got Oligarchy clarification: no permanent exclusion zones; HEF will intervene if temporary defences become monopolies. OLD stresses neutrality and focus on Aquaphid civilians.
|
|
|

*** Inter Galactic News *** RAT returns under Harry Hawker. The organisation is rebuilding practically with outposts and a credit system that rewards deeds, treating the past as a clean slate. Flagritz–AFT war continues. Over a month of fighting with comparable losses; AFT rejected Flagritz surrender terms and attacks are increasing. FCN removes AFT from Acropolis. Sporadic reports say the FCN has forcibly ejected the AFT from the system; no official comment available.
|
|
|

*** Inter Galactic News *** The Falconian Republic (FCN) has declared itself restored under Emperor Scipio Acropolis, ending a period of silence and launching an audit of Acropolis, Falconia, and all related assets, charters, and alliances. The Flagritz Republic (FLZ) says AFT attacks in Tramoss have put it at war with the AFT; it reports about 60 AFT ships destroyed for 20 FLZ losses in the Corewards Periphery, plus an AFT strike on a Halo Periphery platform that remains under FLZ control. The FLZ has also formed a mutual defence alliance with the FET, so an attack on either is treated as an attack on both.
|
|
|

*** Inter Galactic News *** DEN forces launched a successful multi-day assault on FEL positions at Harrappa and Elam, destroying numerous FEL warships with minimal losses of their own, seizing significant ground control, and reducing a key base to rubble; hostilities ended with FEL retaining full control of Elam while DEN gained exploration and mining rights on other bodies.
FET has acquired Starbase Aglaea and is taking over the Highgrace system (claim effective Stardate 226.36.2), keeping it open to peaceful trade.
A low-profile war continues between AFT and OPS, marked by ship losses, boardings, a broken blockade, and reports of OPS deploying large pirate-style fleets.
Separately, the DNA hosted talks (and poker) with the Flagritz Republic and GTT, resulting in the DNA acquiring a starbase from the Flagritz.
|
|
|

*** Inter Galactic News *** Pirate activity remains high, with reports of a ship taken from OPS in Zewt, plus earlier losses of a GTT 50N explorer and a CIA 40N destroyer. In DNA Elections 226, independents achieved a major victory, claiming all leadership positions: Foreign Minister Chairman TonTon, Education Minister Qui'Haktey, and Health Minister Dr. Shawna Tanniek Dorrendarger. The Wodenzoon Group’s withdrawal from politics boosted independents to 34% in the National Assembly, with South Road and Trad-Nap groups also gaining. Results confirm the DNA’s confederate, pragmatic, and mildly traditionalist direction. Foreign policy and business relations are expected to remain stable under the established “Good Neighbour” approach.
|
|
|

*** Inter Galactic News *** OPS has aggressively claimed the Nog Kesri system in the Corewards Periphery, purging AFT forces amid a massive multi-faction fleet presence (DTR, DEN, FEL, FET, FLZ, GTT, MOH, OPS, and PIR). Factions are hunting for a rumored hidden MEK base or rift point, but so far only a ship graveyard and one PIR sensor ship have been found. Meanwhile, PIR activity continues with attacks in Kasmer and Teller, while GTT is cracking down hard on small ships in their territory.
|
|
|

*** Inter Galactic News ***
Kulthean forces struck back against pirates and MRC, destroying a PIR boarding ship in Daggern and capturing three MRC freighters in Brixx, while defending Dryfus from pirate assault.
Meanwhile, Pirate Casio scored a major victory in the Teller system, successfully boarding and capturing two 300 Heavy Hull FEL warships — the Pride of Bannockburn and Pride of Angara — in a single daring raid. Significant prisoners were taken as the pirates withdrew with their prizes.
|
|
|
***Anonymous Submission*** FLZ claim CIV system in the Coreward Arm and try for Another
The FLZ have undertaken a couple of minor scale operation into Xarze and Assanistra systems in the Coreward Arms, claiming the CIV system of Xarze away from local control and have put in a claim in Assanistra to contest that system. When asked the FLZ replied that the operation started as part of their hunting down Pirates (sic)...and then clammed up. Locals have claimed that it is clearly a power grab and imitation flattery.
All CIV claims in Xarze seem to have been crushed by just enough FLZ to effect the claim. Assanistra is sure to follow. Money is on Violet Gate to be the next to come under the claws of the FLZ. These systems coming under FLZ control sees an increasing push by the FLZ to have a reason to go through Damnation Alley and get attacked by the pirates like all the cool affiliations.
***PIR in Fortoon system*** The PIR this last month have attempted to take control of a FEL outpost on Dryfus in Fortoon, sporadic reports suggest an overwhelming force led by the GTT destroyed the hostile PIR ground parties. Questions have been asked of the DNA ability to defend the planet with a number of affiliations offering support
***Noctollis*** The Noctollis system has been claimed away from the DTR by the FLZ Republic with the FLZ announcing the move is at the request of the resurgent DEN affiliation. The AFT have been advised to avoid the Noctollis stargate. Per the system charter (in addition to the DEN) the KRT, FET, DTR , MOH, and GTT are welcome to continue moving ships through Noctollis to reach their assets in-system or deeper in the periphery. All other affiliations are advised to avoid using the stargate
|
|
|
***********An article from Sin Feine Media.......*************
Don't worry, criminals have your back?!?! ---------------------------------------------------------------------------------------------- (Fin Saine media video transmission submitted for Sub-Space-Static publication) ----------------------------------------------------------------------------------------------
(Hooshie of the Clockworks' appearance can best be described as a naplian ruffian, gang member, or scruffy pirate, but it appears he is also today's host. He does sport a nice Big Golden Classic digital watch though, but surprisingly on the inside of his wrist. Fine craftsmanship with bulky steampunk motifs, and a barn door style protective cover built right in. You know, the type with two doors and the locking bar across when closed?!?! Hand crafted! Great watch!
 In what humans have termed a gruff slavic voice, he begins to speak: )
|
|