{{
`${userDetail.user.displayName}${userDetail.user.cachedBungieGlobalDisplayNameCode ? `#${standardizeBungieGlobalCode(userDetail.user.cachedBungieGlobalDisplayNameCode)}` : ""}`}}
{{getUserClans()}}
9/8/2010 12:27:28 AM
74
The API Key Explained *UPDATED*
[b]What is an API?[/b]
An application-programming interface (API) is a set of programming instructions and standards for accessing a Web-based software application or Web tool. A software company releases its API to the public so that other software developers can design products that are powered by its service.
For example twitter has an API so developers can create apps that connect to twitter e.g. Echofon.
[b]What is an API Key?[/b]
The key gives a developer access to Reach's API, inturn giving the developer RAW data. With this key you can get data on Halo Reach players, matches etc. for any applications you are building. For example something like Halocharts has been using the Reach API for getting it's stats.
[b]Reach API Group[/b]
Back when the Beta was out Achronos made a group for this API and invited certain developers in the community access to the API and the group. It was called "Potato" and has had its name changed to "[url=http://www.bungie.net/fanclub/statsapi/Group/GroupHome.aspx]Reach Stats API[/url]". I'm a member and others like Firestream, dazarobbo, paulmarv etc. When the API goes live and gets the green light the group will be open to the public. Until then don't try joining you will be rejected.
[b]Will I need to use my Key?[/b]
Unless you are a developer, no.
To 99.9% of the user this is an irrelevant option.
[b]So when I do this, it allows the developers to gather data on me?[/b]
No the key is to get YOURSELF access to the API. Developers can always get your Halo: Reach data regardless. Though all they can access is your game stats nothing else. The API does not have anything to do with Bungie.net or any personal details.
[b]Do I need my key to use someone else's app?[/b]
No. The API key is only for the developer. Do not give anybody your key as its against the rules for someone to use another persons key. If an app asks for your key report it to Achronos or in the API group when it opens.
[b]Notes[/b]
[quote][b]Posted by:[/b] Achronos
Information on how to develop against the Halo: Reach stats API will be available at www.bungie.net/stats/reach/online.aspx after everything is turned on.
99% of you don't need to care about it.[/quote]
Feel free to ask questions here.
[Edited on 09.13.2010 12:46 PM PDT]
-
[quote][b]Posted by:[/b] ApocalypeX [quote][b]Posted by:[/b] Screecherz [quote][b]Posted by:[/b] ev1l tr1t0n Hmm... only five?[/quote]What exactly happens when a request is completed? Can you only download the stats for 5 people per second? 5 games? 5 days? I'm sorry for not being the most technically inclined, but I do find this really pretty interesting.[/quote] A request is a requesting via connecting to the server for a bundle of data. A bundle of data could be a players service record, game history or a game etc. But this wont matter to the user, only the developer. [/quote] This. Just think of a request as loading a webpage, because that's basically what it is. Anyways, a limit of five is extremely low. Imagine HaloCharts, a website with over 100,000 registered users. When Reach comes out, a lot of people will be wanting to collect their stats. A limit of five simply wouldn't cut it for HaloCharts. However, I wouldn't be surprised if the allotted amount could be changed for different keys if the reason is legitimate (as in the case of HaloCharts and websites like it). [quote][b]Posted by:[/b] FoxHoundNinja 8 [quote][b]Posted by:[/b] ev1l tr1t0n Ah ok, thanks for clarifying. They can do stats like those because they essentially store a list of every person to play Halo 3, along with data such as their player model. All they have to do is write a query that counts the amount of players using each player model. Now, it would be possible to do something like that without having access to a list of all players, but it would take a really long time because you would have to go through every game of Halo 3 played to get a list of all people that have played Halo 3. After that, you would have to go to each player's service record and check their player image URL.[/quote] How detailed is it? could someone write something that counts how many people are using armour pieces like the recon helmet?[/quote] Detailed down to armor piece, color and size of display. Check it out: [url]http://www.bungie.net/Stats/Halo3/PlayerModel.ashx?p1=0&p2=9&p3=3&p4=3&p5=3&p6=0&p7=2&p8=2&p9=145[/url] [Edited on 09.07.2010 7:02 PM PDT]
