Pinned OGame API

Malakian · Jun 7th 2016, 1:20am

Hi guys.

From what I know, using this API directly is not recomended and admins stated to first download data from API to our server and then fetch data from there.

Since direct use of API isn't recomended, I have to make nearly 400,000 requests just to download one entire snapshot.
Wouldn't it be easier if GF provide gzip'ped data which would eventually reduce data size fetch from over 2GB to 200MB and 400,000 request to just one?

Source Code

11M alliances
188M highscore
1.0M localization
1.7G playerData
22M players
956K serverData
197M universe
956K universes
423686 files (where each file equals one request to server)

ImperatorMaximus · Jun 7th 2016, 11:00am

Malakian wrote:

Hi guys.

From what I know, using this API directly is not recomended and admins stated to first download data from API to our server and then fetch data from there.

Since direct use of API isn't recomended, I have to make nearly 400,000 requests just to download one entire snapshot.
Wouldn't it be easier if GF provide gzip'ped data which would eventually reduce data size fetch from over 2GB to 200MB and 400,000 request to just one?

Source Code

11M alliances

188M highscore

1.0M localization

1.7G playerData

22M players

956K serverData

197M universe

956K universes

423686 files (where each file equals one request to server)

Ehm, the use of the old xml api is directly allowed and also recommended :o
The new json api is handled differently and also requires a private api key. This one have to be private, this requests have to be proxied or limited by yourself.

MightyMalcolm · Oct 14th 2016, 6:45pm

Hello everybody,

I have a quick question: am I allowed to load the players.xml and then load the playerData.xml for each and every player in rapid succession? I don't wish to accidently DOS-attack the server. Not really experienced with querying servers and I don't know how much they can take^^

Anyway, any help greatly appreciated. Cheers

TheViking · Oct 16th 2016, 10:50pm

That will be a huge count of requests for sure and i think it depends on how often you want to access that stuff.

So maybe some more details could be useful to help you out with an answer.

Xinthos89 · Feb 9th 2017, 3:42pm

Hello,

could someone give me an example or a list of attributes that the API returns for a spy report?
Thank you in advance.

Regards,
Xinthos

TGWo · Feb 9th 2017, 5:26pm

Display Spoiler

Source Code

stdClass Object
(
[generic] => stdClass Object
(
[sr_id] => b8d56961d3f876af386cc87feeecf92da332e1cb
[event_time] => 2017-02-09T16:22:44+00:00
[event_timestamp] => 1486657364
[total_ship_count] => 0
[total_defense_count] => 11
[loot_percentage] => 50
[spy_fail_chance] => 0
[activity] => -1
[attacker_name] => TGWo
[attacker_planet_name] => Homeworld
[attacker_planet_coordinates] => 1:146:6
[attacker_planet_type] => 1
[attacker_alliance_name] =>
[attacker_alliance_tag] =>
[defender_name] => TGWo1
[defender_planet_name] => Homeworld
[defender_planet_coordinates] => 1:150:4
[defender_planet_type] => 1
[defender_alliance_name] =>
[defender_alliance_tag] =>
[failed_ships] =>
[failed_defense] =>
[failed_buildings] =>
[failed_research] =>
)
[details] => stdClass Object
(
[resources] => stdClass Object
(
[metal] => 140000
[crystal] => 75000
[deuterium] => 40000
)
[buildings] => Array
(
[0] => stdClass Object
(
[building_type] => 1
[level] => 17
)
[1] => stdClass Object
(
[building_type] => 2
[level] => 13
)
[2] => stdClass Object
(
[building_type] => 3
[level] => 5
)
[3] => stdClass Object
(
[building_type] => 4
[level] => 16
)
[4] => stdClass Object
(
[building_type] => 14
[level] => 5
)
[5] => stdClass Object
(
[building_type] => 21
[level] => 3
)
[6] => stdClass Object
(
[building_type] => 22
[level] => 4
)
[7] => stdClass Object
(
[building_type] => 23
[level] => 3
)
[8] => stdClass Object
(
[building_type] => 24
[level] => 2
)
[9] => stdClass Object
(
[building_type] => 31
[level] => 3
)
)
[ships] => Array
(
)
[defense] => Array
(
[0] => stdClass Object
(
[defense_type] => 401
[count] => 11
)
)
[research] => Array
(
[0] => stdClass Object
(
[research_type] => 106
[level] => 4
)
[1] => stdClass Object
(
[research_type] => 108
[level] => 2
)
[2] => stdClass Object
(
[research_type] => 113
[level] => 1
)
[3] => stdClass Object
(
[research_type] => 115
[level] => 3
)
)
[repairOrder] => Array
(
)
)
)

Display All

Xinthos89 · Feb 9th 2017, 7:28pm

Thank you very much.

I have a problem, though: the universe updates on a monday, a player relocates on a tuesday and i'm trying to save a spy report from a wednesday. How can i connect the report to the planet without keeping and searching the relocation history? The coordinates of the planet have changed, and I don't have the planet id in the report.

Thank you.

Regards,
Xinthos

ImperatorMaximus · Feb 14th 2017, 7:04pm

Xinthos89 wrote:

Thank you very much.

I have a problem, though: the universe updates on a monday, a player relocates on a tuesday and i'm trying to save a spy report from a wednesday. How can i connect the report to the planet without keeping and searching the relocation history? The coordinates of the planet have changed, and I don't have the planet id in the report.

No. The id of the planet is hidden by design. Sorry

mmorpg-stat.eu · Jul 7th 2017, 3:25pm

Hello,

A lot of problems since this morning regarding XML files: api

ID alliances have all been changed.

Example Alliance ID: 14 becomes Alliance ID: 500001

For informations:
XML API SK 101 => BUG (1 registered alliance)
XML API US 131 => BUG (1 registered alliance)

Inconsistency between the alliance file and the player file

file :api/alliances.xml

XML Source Code

<alliance id="500001" name="Planetes Barbares Unifiees" tag="PBU" open="1">
<player id="1003266"/>
</alliance>

ID alliance: 500001

file :api/players.xml

XML Source Code

<player id="1003266" name="rune" status="I" alliance="30"/>

ID alliance: 30

Fred

Choubakawa · Jul 12th 2017, 11:26am

Hello,

I have a problem with the link .....playerData.xml

I can't access to the page when I give an ID.

I take an ID from here:
s106-fr.ogame.gameforge.com/ap…ore.xml?category=1&type=0
and try
s106-fr.ogame.gameforge.com/api/playerData.xml?id=159048
but it fail.

And when I remove the ID I get the message

Source Code

Query parameter "id" must be given.
e.g. playerData.xml?id=12345"

What am i doing wrong ?

Crushader · Jul 12th 2017, 4:59pm

nothing, its broken(since new version), i reported already and Polish department said it was passed to devs(here?)

Malakian · Aug 8th 2017, 9:01am

Choubakawa wrote:

Hello,

I have a problem with the link .....playerData.xml

I can't access to the page when I give an ID.

I take an ID from here:
s106-fr.ogame.gameforge.com/ap…ore.xml?category=1&type=0
and try
s106-fr.ogame.gameforge.com/api/playerData.xml?id=159048
but it fail.

And when I remove the ID I get the message

Source Code

Query parameter "id" must be given.

e.g. playerData.xml?id=12345"

What am i doing wrong ?

Any news about fixing that?

NoMoreAngel · Aug 8th 2017, 9:10am

Not yet.

ciap · Aug 25th 2017, 3:32pm

mmorpg-stat.eu wrote:

Inconsistency between the alliance file and the player file

file :api/alliances.xml

XML Source Code

<alliance id="500001" name="Planetes Barbares Unifiees" tag="PBU" open="1">

<player id="1003266"/>

</alliance>

ID alliance: 500001

file :api/players.xml

XML Source Code

<player id="1003266" name="rune" status="I" alliance="30"/>

ID alliance: 30

1.5 months...
When will it be fixed?

ciap · Sep 7th 2017, 12:38pm

"This issue is fixed. If you still cannot use it please contact the Origin admins :)"

Not fixed?

In aliance:
Omega93 96 [1:308:7] 2017-07-15 12:01:07

In API:
s68-pl.ogame.gameforge.com/api/players.xml

API wrote:

<player id="164771" name="markob2" alliance="1039"/>

<player id="164772" name="Omega93"/>

"timestamp="1504699807"" = 09/06/2017 @ 12:10pm (UTC)
Where is the alliance info?

markob2 is in the alliance s68-pl.ogame.gameforge.com/gam…nfo.php?allianceId=500268
OGame ID: 500268, API: 1039 ?

Stop kidding me.
Did anyone even read my issue or it is automatic generated answer?

NoMoreAngel · Sep 7th 2017, 12:44pm

ciap wrote:

"This issue is fixed. If you still cannot use it please contact the Origin admins :)"

I'm curious where you got that answer, would you tell me? Also it was nowhere written that the players.xml is fixed. The playerData.xml has been fixed in the latest version.
There you can also get the correct info:

XML Source Code

<alliance id="500268">
<name>United Cities of Space WKU</name>
<tag>UNITED</tag>
</alliance>

Crushader · Sep 7th 2017, 7:26pm

NoMoreAngel wrote:

ciap wrote:

"This issue is fixed. If you still cannot use it please contact the Origin admins :)"

I'm curious where you got that answer, would you tell me? Also it was nowhere written that the players.xml is fixed. The playerData.xml has been fixed in the latest version.There you can also get the correct info:

XML Source Code

<alliance id="500268">

<name>United Cities of Space WKU</name>

<tag>UNITED</tag>

</alliance>

Not sure where you check but seems like version 6.5.1 fixed it. (please note each server have own version so playerData for one nationality would work and other not because of older version)

vld · Sep 4th 2018, 10:07pm

Hi All,
is it possible to add the "label" tag attribute with label of the universes in universes.xml?

Example:

s40-it.ogame.gameforge.com/api/universes.xml

Source Code: universes.xml

...
<universe id="154" label="Bellatrix" href="https://s154-it.ogame.gameforge.com"/>
<universe id="155" label="Cosmos" href="https://s155-it.ogame.gameforge.com"/>
...

Charlie · Sep 5th 2018, 12:41am

@vld Agree with you. You can see more details here Should /universes.xml be changed?

At the same time, keep in mind you can use:

DeltaT · Sep 5th 2018, 1:43am

vld wrote:

Hi All,
is it possible to add the "label" tag attribute with label of the universes in universes.xml?

I'm agree, could be useful, but at the moment we can take this information from serverData.xml

Source Code

Source Code

Source Code

XML Source Code

XML Source Code

Source Code

Source Code

XML Source Code

XML Source Code

XML Source Code

XML Source Code

Source Code: universes.xml

Share