Application.getPublicInfo
From Facebook Developers Wiki
This API method is currently in Beta.
Contents |
[edit] Description
Returns public information for an application (as shown in the application directory) by either application ID, API key, or canvas page name.
[edit] Parameters
| Required | Name | Type | Description | |
| required | api_key | string | The application key associated with the calling application. | |
|---|---|---|---|---|
| sig | string | An MD5 hash of the current request and your secret key, as described in the authentication guide. | ||
| v | string | This must be set to 1.0 to use this version of the API. | ||
| optional | application_id | int | Application ID of the desired application. You must specify exactly one of application_id, application_api_key or application_canvas_name. | |
| application_api_key | string | API key of the desired application. You must specify exactly one of application_id, application_api_key or application_canvas_name. | ||
| application_canvas_name | string | Canvas page name of the desired application. You must specify exactly one of application_id, application_api_key or application_canvas_name. | ||
| format | string | Desired response format. Either XML (default) or JSON. | ||
| callback | string | Name of a function to call. This is primarily to enable cross-domain JavaScript requests using the <script> tag, also known as JSONP, and works with both the XML and JSON formats. The function will be called with the response passed as the parameter. |
[edit] Example Return XML
| <?xml version="1.0" encoding="UTF-8"?> <application_getPublicInfo_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd"> <app_id>2413267546</app_id> <api_key>c756401cb800e295f21d723b7842ea83</api_key> <canvas_name>ilike</canvas_name> <display_name>iLike</display_name> <icon_url>http://photos-c.ak.facebook.com/photos-ak-sctm/v43/130/2413267546/app_2_2413267546_6706.gif</icon_url> <logo_url>http://photos-c.ak.facebook.com/photos-ak-sctm/v43/130/2413267546/app_1_2413267546_2324.gif</logo_url> <developers list="true"/> <company_name>iLike, inc</company_name> <description>iLike lets you add music to your profile and find your favorite concerts (not to mention see who else is going!). Bonus: Use it to get free mp3’s that match your tastes and try to beat your friends at the Music Challenge.</description> <daily_active_users>392008</daily_active_users> <daily_active_percentage>3</daily_active_percentage> </application_getPublicInfo_response> |
[edit] Error Codes
| Code | Description | |
| 1 | An unknown error occurred. Please resubmit the request. | |
|---|---|---|
| 2 | The service is not available at this time. | |
| 4 | The application has reached the maximum number of requests allowed. More requests are allowed once the time window has completed. | |
| 5 | The request came from a remote address not allowed by this application. | |
| 100 | One of the parameters specified was missing or invalid. For example, not passing exactly one of application_id, application_api_key or application_canvas_name. | |
| 101 | The API key submitted is not associated with any known application. | |
| 104 | Incorrect signature. | |
| 900 | No such application exists. |
[edit] Notes
This function does not require a session_key or call_id (although specifying a call_id does not cause any problems).
