API/Code/AppInfo
Quick Links
AppInfo API
The AppInfo API allows you to request information such as name, version, apiKey, platform, and creation date of one or all of your company's applications.
Making a request
Requests should be of the form:
http://api.flurry.com/appInfo/METRIC_NAME?apiAccessCode=APIACCESSCODE &apiKey=APIKEY
Where the METRIC_Name is one of the following:
| getApplication | Information on a specific project. |
| getAllApplications | Information on all projects under a specific company. |
APIACCESSCODE is the unique code given to you to access Flurry APIs. This can be found by logging into
the Flurry website and by going to the link "manage"
APIKEY is the unique code for each application. This can be found by logging into the Flurry website, then by going to the link "Manage Applications" and finally by selecting the application desired.
Response format
Flurry APIs current support two output formats: XML and JSON.
The format of the response data depends on the value of the Accept header you send in the HTTP request. If you specify "application/xml" when calling getApplication you will receive an XML-formatted response similar to the following:
<appInfo name="Project Name" version="1.0" generatedDate="3/1/10 2:10 PM"
createdDate="2010-03-01" platform="Platform" category="Category">
<version name="1.0" createdDate="2010-03-01" />
<version name="2.0" createdDate="2010-03-02" />
...
</appInfo>
<appInfo name="Project Name" version="1.0" generatedDate="3/1/10 2:10 PM" createdDate="2010-03-01" platform="Platform" category="Category"> <version name="1.0" createdDate="2010-03-01" /> <version name="2.0" createdDate="2010-03-02" /> ... </appInfo>
If you specify "application/json" you will receive a JSON-formatted response similar to the following.
{"@name":"Project Name",
"@version":"1.0",
"@generatedDate":"3/1/10 2:10 PM",
"@createdDate":"2010-03-01",
"@platform":"Platform",
"version":[{"@name":"1.0",
"@createdDate":"2010-03-01"},
{"@name":"2.0",
"@createdDate":"2010-03-02"},
...
]
}
{"@name":"Project Name",
"@version":"1.0",
"@generatedDate":"3/1/10 2:10 PM",
"@createdDate":"2010-03-01",
"@platform":"Platform",
"version":[{"@name":"1.0",
"@createdDate":"2010-03-01"},
{"@name":"2.0",
"@createdDate":"2010-03-02"},
...
]
}
If you specify "application/xml" when calling getAllApplications you will receive an XML-formatted response similar to the following:
<applications companyName="Company Name" version="1.0"
generatedDate="3/1/10 2:10 PM">
<application name="Application #1 name" apiKey="1234"
createdDate="2010-03-01" platform="Platform" />
<application name="Application #2 name" apiKey="4321"
createdDate="2010-03-02" platform="Platform" />
...
</appInfo>
<applications companyName="Company Name" version="1.0" generatedDate="3/1/10 2:10 PM"> <application name="Application #1 name" apiKey="1234" createdDate="2010-03-01" platform="Platform" /> <application name="Application #2 name" apiKey="4321" createdDate="2010-03-02" platform="Platform" /> ... </appInfo>
If you specify "application/json" when calling getAllApplications you will receive a JSON-formatted response similar to the following.
{"@companyName":"Company Name",
"@version":"1.0",
"@generatedDate":"3/1/10 2:10 PM",
"application":[{"@name":"Application #1 name",
"@apiKey":"1234",
"@createdDate":"2010-03-01"
"@platform": "Platform name"},
{"@name":"Application #2 name",
"@apiKey":"4321"},
...
]
}
{"@companyName":"Company Name",
"@version":"1.0",
"@generatedDate":"3/1/10 2:10 PM",
"application":[{"@name":"Application #1 name",
"@apiKey":"1234",
"@createdDate":"2010-03-01"
"@platform": "Platform name"},
{"@name":"Application #2 name",
"@apiKey":"4321"},
...
]
}
Error codes
If something is wrong with the request or if there is a system problem, you will recieve an error response instead of the expected response. This is signified by an HTTP response code other than 200 (OK) and is accompanied by content similar to the following:
<error>
<code>100</code>
<message>API Key not found</message>
</error>
<error> <code>100</code> <message>API Key not found</message> </error>
If you receive one of these errors and are unable to determine the cause from the message provided, please contact Flurry support (support@flurry.com) along with the error code you receive.
In some cases, a system error will occur that prevents even an error message from being returned. In these cases you will receive a 500 server failure response code.
