Archaeology.pod

Archaeology Ministry Methods

Archaeology Ministry is accessible via the URL /archaeology.

The list of methods below represents changes and additions to the methods that all Buildings share.

view ( session_id, building_id )

{
   "status" : { ... },
   "building" : { ... },
}

If a search is active, the work block will be included. In the work block, there is an additional item not included in other work blocks: searching. c<searching> will contain the name of the ore being searched.

search_for_glyph ( session_id, building_id, ore_type )

Searches through ore looking for glyphs left behind by the ancient race. Takes 10,000 of one type of ore to search. Returns view.

session_id

A session id.

building_id

The unique id of the Archaeology Ministry.

ore_type

One of the 20 types of ore. Choose from: rutile, chromite, chalcopyrite, galena, gold, uraninite, bauxite, goethite, halite, gypsum, trona, kerogen, methane, anthracite, sulfur, zircon, monazite, fluorite, beryl, magnetite

subsidize_search ( session_id, building_id )

Will spend 2 essentia to complete the current glyph search immediately. Returns view.

Throws 1011.

session_id

A session id.

building_id

The unique id of the Archaeology Ministry.

get_glyphs ( session_id, building_id )

This API call is now deprecated, please use get_glyph_summary instead.

get_glyph_summary ( session_id, building_id )

Returns a summary of all glyphs that may be assembled in this archaeology ministry. Used with the assemble_glyphs method.

{
   "glyphs" : [
       {
           "id" : "id-goes-here",
           "name: : "bauxite",
           "type" : "bauxite",
           "quantity" : 2
       },
       ...
   ],
   "status" : { ... }
}

session_id

A session id.

building_id

The unique id of the Archaeology Ministry.

assemble_glyphs ( session_id, building_id, glyphs, [ quantity ] )

Turns glyphs into rare ancient items. Returns:

{
   "status" : { ... },
   "item_name" : "Volcano"
}

session_id

A session id.

building_id

The unique id of the Archaeology Ministry.

glyphs

An array reference containing an ordered list of up to four glyph types.

quantity

An optional quantity; if left blank it defaults to 1, otherwise specify the number of times to assemble the indicated glyphs up to a maximum of 5000.

get_ores_available_for_processing (session_id, building_id)

Returns a list of ore names that the user has enough of to process for glyphs.

{
   "status" : { ... },
   "ore" : {
       "bauxite" : 39949,
       "rutile" : 19393
       }
}

session_id

A session id.

building_id

The unique id of the Archaeology Ministry.

view_excavators ( session_id, building_id )

Returns a list of the excavator sites currently controlled by this ministry.

{
   "status" : { ... },
   "max_excavators" : 2,
   "travelling" : 1,
   "excavators" : [
       {
           "id" : "id-goes-here",
           "body" : {
               "id" : "id-goes-here",
               "name" : "Kuiper",
               "x" : 0,
               "y" : -444,
               "image" : "a1-5",
               ...
           },
           "artifact" : 5,
           "glyph" : 30,
           "plan" : 7,
           "resource" : 53
           "date_landed" : Date excav started at location
       },
       ...
   ]
}

The chances numbers give the chances out of 100 that a certain result is found by your excavator each hour.

session_id

A session id.

building_id

The unique id of the archaeology ministry.

abandon_excavator ( session_id, building_id, site_id )

Close down an existing excavator site.

{
   "status" : { ... }
}

Throws 1002.

session_id

A session id.

building_id

The unique id of the archaeology ministry.

site_id

The unique id of the excavator site you wish to abandon.

mass_abandon_excavator ( session_id, building_id, ship_ids )

Destroy all excavators.

session_id

A session id.

building_id

The unique id for the archaeology ministry.