Conquer Club API

Discuss developing tools and get details on Conquer Club's API.

Moderator: Tech Team

Forum rules
Please read the Community Guidelines before posting.
Dako
Posts: 3987
Joined: Sun Aug 26, 2007 9:07 am
Gender: Male
Location: St. Petersburg, Russia
Contact:

Re: Conquer Club API

Post by Dako »

One more API bug:

Following link is not working
http://www.conquerclub.com/api.php?mode ... s%20Empire

Reason - I guess it is the ' sign in the map name that messes things up (cause it should be stripped from input). Escaping the character doesn't give anything.
Image
Dako
Posts: 3987
Joined: Sun Aug 26, 2007 9:07 am
Gender: Male
Location: St. Petersburg, Russia
Contact:

Re: Conquer Club API

Post by Dako »

Another bug (or what?).

http://www.conquerclub.com/api.php?mode ... gn=6272744

Should list 4 teams with 2 players each, 6 of slots empty. But right now it returns only 2 players for the game. No way to find how many players there should be.
Image
User avatar
chipv
Head Tech
Head Tech
Posts: 3054
Joined: Mon Apr 28, 2008 5:30 pm

Re: Conquer Club API

Post by chipv »

Thanks for the excellent bug reports, Dako, keep them coming!

Alexander's Empire looks like a bug and I agree with waiting games showing empty slots.
User avatar
chipv
Head Tech
Head Tech
Posts: 3054
Joined: Mon Apr 28, 2008 5:30 pm

Re: Conquer Club API

Post by chipv »

Dako wrote:One more API bug:

Following link is not working
http://www.conquerclub.com/api.php?mode ... s%20Empire

Reason - I guess it is the ' sign in the map name that messes things up (cause it should be stripped from input). Escaping the character doesn't give anything.


Fixed (thanks for quick response, lack)
Dako
Posts: 3987
Joined: Sun Aug 26, 2007 9:07 am
Gender: Male
Location: St. Petersburg, Russia
Contact:

Re: Conquer Club API

Post by Dako »

So for now, these are the bugs/change requests I've found top priority (for my scripts at least, but I know Foxy will be glad for #1 and #4 to be fixed):

  1. [CR] - Player API doesn't return if the member is premium or freemium
  2. [CR] - Gamelist API doesn't indicate blocked players in freestyle games
  3. [BUG] - Gamelist API still have "Time remaining" clock running down after the game was finished
  4. [BUG] - Gamelist API never shows empty player slots for a game (it just skips them)

Maybe I will find something else in the next few days, but for now my script runs smoothly with the new API. Kudos to lack.
Image
barrycarter
Posts: 51
Joined: Sat Jul 31, 2010 10:42 am

Re: Conquer Club API

Post by barrycarter »

To confirm, the API won't tell you who has how many troops on which territories for a given game, correct? Even with the gn query, the info you get is limited, yes?
sherkaner
Posts: 1595
Joined: Thu May 03, 2007 3:21 am
Gender: Male
Location: Zwolle

Re: Conquer Club API

Post by sherkaner »

Correct, it's only general info.
barrycarter
Posts: 51
Joined: Sat Jul 31, 2010 10:42 am

Re: Conquer Club API

Post by barrycarter »

And using a program to auto-login myself and scrape the info from the JSON data on the game page is considered a bad thing, yes?
sherkaner
Posts: 1595
Joined: Thu May 03, 2007 3:21 am
Gender: Male
Location: Zwolle

Re: Conquer Club API

Post by sherkaner »

Depends, not in all cases. For instance I think the Game Link-plugin actually uses the fact that you're already logged in to retrieve the game pages and use the info from those pages, which looks like what you're planning to do. But that's quite heavy, so it's not advised.
Dako
Posts: 3987
Joined: Sun Aug 26, 2007 9:07 am
Gender: Male
Location: St. Petersburg, Russia
Contact:

Re: Conquer Club API

Post by Dako »

It's not bad - it is slow and hard to code/support. Any change to game layout will give you a bunch of work to up[date the tool. While abstract API just gives the data you need.
Image
barrycarter
Posts: 51
Joined: Sat Jul 31, 2010 10:42 am

Re: Conquer Club API

Post by barrycarter »

Thanks. My thought was to create a site where people enter a CC game number, and get various stats, who has best probability of winning, warnings (like: "if red grabs foo, he'll get a bonus"), etc.

Having the maps in XML format is really useful for general strategies, but I was thinking of a game-specific real-time strategy.
Foxglove
Posts: 1308
Joined: Sun Dec 16, 2007 1:05 pm

Re: Conquer Club API

Post by Foxglove »

sherkaner wrote:Depends, not in all cases. For instance I think the Game Link-plugin actually uses the fact that you're already logged in to retrieve the game pages and use the info from those pages, which looks like what you're planning to do. But that's quite heavy, so it's not advised.


Once the API provides the required information, there will be no need to do it the "heavy" way anymore. But for now... that's the only way to allow the script to work properly!
sherkaner
Posts: 1595
Joined: Thu May 03, 2007 3:21 am
Gender: Male
Location: Zwolle

Re: Conquer Club API

Post by sherkaner »

Foxglove wrote:
sherkaner wrote:Depends, not in all cases. For instance I think the Game Link-plugin actually uses the fact that you're already logged in to retrieve the game pages and use the info from those pages, which looks like what you're planning to do. But that's quite heavy, so it's not advised.


Once the API provides the required information, there will be no need to do it the "heavy" way anymore. But for now... that's the only way to allow the script to work properly!

:) Yeah, obviously you have a valid point. And I use and love the script btw (except when I get on a forum page with 100+ games I'm not interested in).
barrycarter
Posts: 51
Joined: Sat Jul 31, 2010 10:42 am

Re: Conquer Club API

Post by barrycarter »

Can you get game start time from the API? The events field doesn't include "game initialized" and I can't see it anywhere else.
barrycarter
Posts: 51
Joined: Sat Jul 31, 2010 10:42 am

Re: Conquer Club API

Post by barrycarter »

BTW, I'm working on a greasemonkey script:

http://github.com/barrycarter/bcapps/bl ... ub-game.js

that scrapes current data from a game page and posts it to my website, where it gets logged but nothing else happens.

If anyone's interested in helping out, please ping me, thanks.
User avatar
Qyu
Posts: 96
Joined: Wed May 30, 2007 6:51 am
Location: Under my helmet
Contact:

Re: Conquer Club API

Post by Qyu »

just one thing, in your 'how to' here :

chipv wrote:[...]
So let's look at a typical output.

Using

Code: Select all

http://www.conquerclub.com/api.php?p1un=chipv

Root tag is <api>

Code: Select all

<api>
   <page>1 of 2</page>
   <games total="244">

[...]


you forget in the url the get var 'mode=gamelist'
so you don't have gamelist but the rules of the API
Image
User avatar
chipv
Head Tech
Head Tech
Posts: 3054
Joined: Mon Apr 28, 2008 5:30 pm

Re: Conquer Club API

Post by chipv »

The head post needs updating will do it now.

Adding requests

1. Allow search by dates. Add 2 parameters from and to, choose whatever date format you want.
2. Indicate blocked players in freestyle status. (Now reads Ready)

Maybe 2 has already been asked for.
kruthar
Posts: 3
Joined: Thu Apr 07, 2011 1:16 am

Re: Conquer Club API

Post by kruthar »

Hi all -

Please let me know if this functionality exists somewhere but I am looking for the turn number for all of the events that get returned on game objects, currently they only come with a timestamp, which really isn't all that useful unless you are doing real-time monitoring. This would allow for some interesting player/game analysis that I plan on doing.

Can I formally request that all events for a game object come with a turn number? Thanks a whole bunch.
User avatar
ender516
Posts: 4455
Joined: Wed Dec 17, 2008 6:07 pm
Gender: Male
Location: Waterloo, Ontario

Re: Conquer Club API

Post by ender516 »

If you need a quick workaround, look for the events that say "Incrementing to round n".
Army of GOD
Posts: 7192
Joined: Tue Feb 24, 2009 4:30 pm
Gender: Male

Re: Conquer Club API

Post by Army of GOD »

for the maps, what's the syntax for a map that has a space in its name (e.g. if I wanted to get the xml for Far East)? I can't seem to figure it out...

Edit: never mind, didn't realize it was case sensistive
Last edited by Army of GOD on Fri Sep 06, 2013 4:59 pm, edited 1 time in total.
mrswdk is a ho
User avatar
Qyu
Posts: 96
Joined: Wed May 30, 2007 6:51 am
Location: Under my helmet
Contact:

Re: Conquer Club API

Post by Qyu »

The mode=group doesn't work for every clan.
Only the older one works fine (ex : http://www.conquerclub.com/api.php?mode=group&g=193056)
but not for the most recent (ex : http://www.conquerclub.com/api.php?mode=group&g=193216)
Image
Hugo Estrada
Posts: 10
Joined: Thu Jan 22, 2009 11:36 am

Re: Conquer Club API

Post by Hugo Estrada »

Can you create games and invite people with the api? It seems like you can't, but I am not sure how up to date the documentation is.
User avatar
dgz345
Posts: 1363
Joined: Thu Oct 07, 2010 10:53 am

Re: Conquer Club API

Post by dgz345 »

nope you can not create games with the api. what i know of. but you can find ppl and you can create games with the link you get from creating games

http://www.conquerclub.com/player.php?n ... mit=Create

will create a 1v1 on AYBA.. and invite me

show
User avatar
MrBenn
Posts: 6880
Joined: Wed Nov 21, 2007 9:32 am
Location: Off Duty

Re: Conquer Club API

Post by MrBenn »

This is an excellent guide... The first post needs updating to add (P)olymorphic to the game type section

Code: Select all

gt - game type (S)tandard, (C)Terminator, (A)ssassin, (P)olymorphic, (D)oubles, (T)riples or (Q)uadruples 
Image
PB: 2661 | He's blue... If he were green he would die | No mod would be stupid enough to do that
User avatar
GeneralFault
Posts: 137
Joined: Fri Jul 11, 2008 4:02 am
Gender: Male
Location: Leiden, the Netherlands
Contact:

Error in API (maplist)

Post by GeneralFault »

http://www.conquerclub.com/api.php?mode=maplist

anyone any idea why this xml does not work?

fault is: error on line 999 at column 29: Char 0x0 out of allowed range
Image
Post Reply

Return to “Tools Development”