Clash of Clans API for clan leaders/managers
This is a huge ask, and there may be a lot that's impractical about it, but I thought I'd bring it up in case it catches on. It would be great to have a web-based API for CoC where a clan leader can automatically query clan members and their statistics/role. Our clan has a website and membership on the website has to be maintained independently of the game, so someone always has to be watching for people leaving the clan so that their account can be blocked on the website. When someone gets promoted to elder in game, it would be nice to be able to automatically give them elder status on the website, etc.. It would also make it easier to run in-clan contests if we could devise a program to query the (for example) troop donation counts for each member, their trophies lost and won, etc...
Anyone at Supercell feel like taking on this monumental task? :o
Big Ups for even a minimalist API
I'll echo this API request.
Our adult-only Clan, "The ever living", has a strong culture of mutuality, i.e. heavy donation rates.
We also feel strongly about loyalty, so operate on the presumptive basis that All Bootings Are Forever.
Naturally, when we take the Ultimate Sanction of booting someone for being "too much of a Taker, and not enough of a Giver", our Leader & Elders want to be as sure as reasonably possible that the case against the member is supported by objective data. Since the weekly donation tracking was added a couple Updates ago, this is much easier to assess than it was, which we do appreciate!
However, we still must manually capture the weekly donation counts just prior to Reset, via the somewhat tedious method of taking screenshots - at the last possible moment before Reset - manually; then transcribing the donation data manually into a spreadsheet; then finding a (necessarily out-of-band) way to make the breakdown visible to at least the Leader & Elders, if not the entire Member list.
Aside from the obvious improvement in convenience & accuracy of replacing that method with either a pull or push API call, this behavioral data is incomplete, so does not help us with another key part of the ongoing "parasite detection and pruning" analysis as much as we'd like: tracking Members' Requests to Donations ratio.
It would sure be nice to be able to a) see the Requests Fulfilled//Troops Received values (in whichever units Supercell might prefer: actual Unit lists; simple Request counts; Castle spaces filled, etc), and b) be able to get that info directly either as a Push to the Clan Leader [via Notifications, email, API dequeueing, whatever], or pulled via explicit polling API.
An API will enable a brand-enhancing ecosystem of value-added CoC tools to be developed by third parties. These will add further stickiness and positive UX value without having to be built or maintained by the Supercell dev team, preserving their vital mission focus.
I firmly believe it would be perfectly reasonable for Supercell to change the API as frequently as they wish, leaving third-party devs to either do the work to adapt as necessary, or accept that their tools will quickly be obsoleted - given the admirable rate of significant, rapid enhancement for the player experience which has already been established via Update for the game itself.
Would love to discuss this further with any other interested parties.
Adrian
This information is probably already collected in a data warehouse
Quote:
Originally Posted by
AvalonDaebust
A simple query to the DB that CoC runs on should be enough so implementation should take only in a timeframe of hours.
You wouldn't be querying the live data.
This information is probably already collected in a data warehouse, and could be made available via web services. But that would require some dedicated infrastructure $$.
How often is that data refreshed..? Every two weeks during the reset..?
A two week old snapshot of a clans stats before the reset, is reasonable.
Anything refreshed more frequently than that is gravy.
Give an ability to every player to show his progress in the game over internet!
If you open api for every one - it would be really cool.
another solution is to give every user an ability to get image of html source for showing his game profile or progress in the Internet.
Clash of Clans TPMs don't be silent, give us your opinion or decision.
Thank you.
Not a want, but a necessity!
Set aside the cost and resource argument, surely, this can only better the game.
As someone commented, it be very simplistic such as name, level, trophies and resource levels.
Another Programmer / Web Developer here.
I'm a programmer as well, and would love the ability to utilize an API. I'm sure clan websites would utilize this, display stats, let users link accounts to gaming accounts, and communicate outside of the game. I'm sure the number of websites for clans would grow creating more popularity and fun for the game.
Mike
Another web developer checking in.
We need this more than ever now. Please listen to us Supercell!
This would make our life so much easier!
I would like to add, i want a API because I also am a programmer, how original...
Anyhow,
I would use the API to get a statistics of my clan
Like how much they donated ofc.
When they were online for the last time.
Amount of trophies they have.
so i am able to store the history of every player.
but most of all to check how active a clan member is.
Since the clan wars been arround we noticed that more then half our clan is just not arround when you need them.
We wanna limit the amount of inactive players in our clan.
Give me something to do this, if not a api then put a last-logged in thing in clan-member list. able to be seen by the clan leader.
HELP this is a bummer atm.
so please consider and API+1 like they do above.
+1 from another software engineer
+1 from yet ANOTHER web developer!
This has my vote! The question is, how many non-software people are interested in this? Perhaps Supercell would have to write a basic, easy-to-learn, programming language just for beginners. 'Clashscript'
more then programmers benefit
Quote:
Originally Posted by
Square
This has my vote! The question is, how many non-software people are interested in this? Perhaps Supercell would have to write a basic, easy-to-learn, programming language just for beginners. 'Clashscript'
If there was an open api and say only 100 programmers that used it which I am sure there are a ton more then that. And lets say only a hand full of them created something that was for more then just their own clan but for the entire CoC community. Then that means that millions benefit from opening of the api. I myself plan on building a site to allow clans to create a profile on. That is depending on how much the api can do.
I think I also want an API for base layouts.
so that I won't spend a whole 10 minutes just changing my base according to an image! I will be able to just one-click to change or add (if there's a save base feature) bases!!
This is a must! +1 for API
Please give us an API, as someone previously mentioned, even if it's a xml with names of clan members, donation amounts, level, resources etc...anything!
VERY GOOD IDEA - But how long does ist take
I saw that the discussion started on 2013. Can someone give more informations about realase date.
Thank you
+1 Yet from another engineer
Huge up, this would be absolutely amazing!
Any reverser/software developer contact me please, I've a little idea about this. :)
according to a network log
I found an app in the Play store named "network connections" which was able to display connections per application running on my device.
Clash of Clans appears to make several connections on port 443, suggesting what we already know - they have a private API layer already in place, rightfully secured using HTTPS.
Additionally, the IP trace points back to AWS (Amazon Web Services). This means they're already able to scale demand for that API layer, or the game would stutter and lag given the number of concurrent users.
The API layer must follow the same workflow as the game, where if we consider how we would want to use it, would be something like this:
+ searchClansByName(name)
Returns an array of objects. Properties would include clanId, name, totalMembers, warsWon, etc, or just clanId at a minimum.
We would then find the object for our respective clans, and then use our clanId for:
+ lookupClanById(clanId)
This again would return object details about the clan (useful if the previous method did not already return this info), along with either an array of memberId values or an array of objects outlining all members and their associative properties.
The order of the members returned should be in the same order they appear in the game, ordered by trophyCount.
If we need to call a method to look up member properties, we would use memberId:
+ lookupMemberById(memberId)
The result from this method would be a series of properties including the current level for every structure of the user's village, the level for each troop type, total number of attacks and defends, total number of stars won in war, etc.
With this information, every clan could make their own dynamic clan page that would update user stats automatically without the need for manual data entry and a database.
It seems really pointless to me to go about managing this data manually when Supercell clearly has an API layer already in use. They simply need to make a few methods public.
I disagree about the need for an API key or charging us to access the API. Since we would only need GET access we couldn't write data back through the API, making it read-only. Aside from identifying who is using the API, a key shouldn't be necessary.
The number of public API requests would be nothing compared to the number of requests running constantly by people playing the game, meaning the cost to support this from an AWS standpoint would be next to nothing. (If anything, creating a public API layer would drive more business, as it would allow individual clans to broadcast their competitiveness across the web. That's effectively free advertising for Supercell, which in turn would generate more users.)
In terms of development it should take very little time for them to test and implement this (I build APIs almost on a daily basis - its not that hard to do), as the methods in the examples I outlined must already exist. All they need to do is make certain methods public which will allow us to build our own dynamic clan pages.
Interested lead developer and clan leader
This thread gets my vote!
I was specifically looking for an API via Google and found this thread. I'm glad to see, I'm not the first. Being someone who's worked on large systems, I see challenges here:
- How will they verify a person is who they say they are when calling the API? There needs to be a process to verify the identity in-game.
- Most of the data from the game is managed by removing it fairly quickly. The season is only 2 weeks, the replays are only 24 hours... They will need a specific data warehouse to support this request that doesn't have the same turnover that the system that supports the main application has.
- I wonder how and when the data for a specific member of a clan is understood to be owned by the clan for export. Does this stop the moment they leave the clan?
I'd like to brainstorm about these issues and possibly be a beta tester of the services once they are developed.
Since there are a number of people interested, once these services are available, a web application could be written to allow interested clan leaders to pull statistics and report them to the clan. Once this code is shared, everyone could use it to make educated decisions about the management of their clan. I've seen many reports that the only way to manage clan data, now (and I have done this) is to write it down manually "as you go." There's an opportunity here and knowing how we could create tools that could empower clans is ripe for the taking. We just need the support.
New tool to Manage your Village
Hi!!!!
I've created a new tool to help managing your village, it works great and in the next days i'll increase the reports that it give you:
http://www.clashofclansmanager.com
If Supercell creates and Api would be awesome, I'd be able to link it!
I hope you like it!
