Find User here you can look for a user

[API] Colony Info

7y
#1
https://mc1.my-colony.com/api.php?pf=2&g=1&c=0hZgBkjn
(replace 0hZgBkjn with desired charter code)

Returns JSON formatted data on specified colony, as well as mother colony and list of child colonies.

{
"charter":"EfbgdYs6",
"name":"EMERALD CITY",
"civilization":"United Earth",
"race":"Human",
"maptype":"Red Planet",
"founded":"December 16, 2016",
"independence":"December 18, 2016",
"population":24718,
"gdp":1484542777812088300,
"unemployment":0,
"mapstage":4,
"playson":"web",
"lastactive":"2017-04-28 09:42:03",
"theme":"#2867ed",
"screenshot":"https://www.my-colony.com/screenshots/ss-146399.jpg",
"website":"https://www.my-colony.com/colonies/EfbgdYs6/",
"sector":"0,1",
"location":"-90,-442",
"rrr":72,
"mothercolony": {
"name":"United Earth",
"charter":"earth",
"website":"https://www.my-colony.com/colonies/earth/",
"relations":100,
"sector":"0,0",
"location":"0,0"
},
"childcolonies": [
{
"name":"TouristsDieHere",
"charter":"GE7RmoX0",
"population":76189,
"website":"https://www.my-colony.com/colonies/GE7RmoX0/",
"relations":92,
"sector":"0,0",
"location":"0,0"
}
]
}
  • charter: charter code
  • name: colony name
  • civilization: what civ they are playing as, like United Earth or Zolarg Empire (so far)
  • race: what species they are.  so far there are human and zolarg.  eventually there may be more than one civilization per race
  • maptype: what map they are playing, like Red Planet, Lunar, etc
  • founded: when the colony was founded
  • independence: when they gained independence, or "0" if they are not independent
  • population: their population
  • gdp: their total gdp
  • unemployment: unemployment rate, times 100, ie  5% would be 5 and not .05
  • mapstage: what their atmosphere level based stage is
  • playson: what platform they last used, like web, android, ios, windows, desktop 
  • lastactive: timestamp of when they last played
  • theme: the theme color they chose in their colony website options
  • screenshot: if they uploaded a screenshot, the url will be here
  • website: the url to their colony website
  • sector: the x,y coordinate of what sector their colony is located in
  • location: the x,y coordinate of where they are located within the above sector
  • rrr: the RRR index of the colony ( http://forum.ape-apps.com/showthread.php?tid=1994 )
  • mothercolony.name: name of their mothercolony
  • mothercolony.charter: charter for their mothercolony
  • mothercolony.population: the population of their mothercolony
  • mothercolony.website: mothercolony website
  • mothercolony.relations: the relation percentage the colony has with their motherland, times 100, ie 95% = 95, not .95
  • mothercolony.sector: the x,y coordinate of the sector their mother colony is in
  • mothercolony.location: the x,y coordinate the mother colony is in within their sector
  • mothercolony.rrr: the RRR index of the colony ( http://forum.ape-apps.com/showthread.php?tid=1994 )
  • childcolonies (array, from largest to smallest):
  • childcolonies[x].name: name of child colony
  • childcolonies[x].charter: child colony charter code
  • childcolonies[x].population: child colony population
  • childcolonies[x].website: website for the child colony
  • childcolonies[x].relations: percent relation that the child colony has with parent, times 100, ie 95% = 95, not .95
  • childcolonies[x].sector: x,y coordinate of the sector child colony is in
  • childcolonies[x].location: x,y coordinate of the child colony location within their sector
Owner of Ape Apps, LLC
6y
#2
Hi, since you added the owner on a colony's website, can you also add it in the API ?

Edit : also, the links about the rrr are dead
Creator of Coloniae
Admin of the MC2 translation project
6y
#3
Maybe you can add a "isRegion" field
Creator of Coloniae
Admin of the MC2 translation project
6y
#4
Account name and Region status have been added to the API
Owner of Ape Apps, LLC
6y
#5
Thanks again!
Creator of Coloniae
Admin of the MC2 translation project
My Colony





Welcome
Ape Apps, LLC is an independent software development company founded in 2010 by Brandon Stecklein. Over the years, Ape Apps has published over 400 apps and games across various platforms. You can get in touch with Brandon on Twitter or by leaving a post on his wall @bastecklein
App of the Day