Data.getUserPreferences
From Facebook Developer Wiki
Note: Support for this method is temporarily disabled until we support user-level permissions. You can still make this call, but you must include your application secret.
Gets currently authenticated user's all preferences.
Contents |
Parameters
| Type | Name | Description |
|---|---|---|
| string | api_key | The application key associated with the calling application. |
| string | session_key | The session key of the logged in user. |
| float | call_id | The request's sequence number. Each successive call for any session must use a sequence number greater than the last. We suggest using the current time in milliseconds, such as PHP's microtime(true) function. |
| string | sig | An MD5 hash of the current request and your secret key, as described in the authentication guide. |
| string | v | This must be set to 1.0 to use this version of the API. |
| string | format | Optional - desired response format. Either "XML" (default) or "JSON". |
| string | callback | Optional - wrap the response inside a function call. This is primarily to enable cross-domain javascript requests using the <script> tag, sometimes known as "JSONP". This works with both XML and JSON. |
Return Value
map: id-value pairs of preferences. For preferences that are set to 0 or empty strings, they will NOT show up in the returned map.
-This is a problem if you identify the preferences by numbers on your machine. If a user fills out preference 0, 1, 2, and 4, but neglects to fill out preference 3 (because it may be optional) --> The array returned by this function will map preference 4 to 3. This preference will still be identified by 4 because each initial key in the returned array stores another array that would map 4 to the user preference, but you may have to iterate through each array until you find this missing preference depending on how many preferences you have and how many are missing. --Arcfoundation 03:39, 29 June 2008 (PDT)
PHP Client Coding Examples
FQL Equivalent
(none)
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. |
| 101 | The api key submitted is not associated with any known application. |
| 102 | The session key was improperly submitted or has reached its timeout. Direct the user to log in again to obtain another key. |
| 103 | The submitted call_id was not greater than the previous call_id for this session. |
| 104 | Incorrect signature. |
| 800 | Internal error. Please report this to Facebook when getting this error. |
| 802 | Quota exceeded. Certain maximum number allocated for an application or a user is exceeded. |
| 805 | A temporary database failure happened. Usually this can be corrected by a re-try. |
