Data.getAssociations
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.
Get all associations between two object identifiers.
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" or "JSON". (Default value is XML.) |
| 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. |
| int64 | obj_id1 | Object identifier 1. |
| int64 | obj_id2 | Object identifier 2. |
| boolean | no_data | True if only return object identifiers; false to return data and time as well. (Default value is true.) |
Return Value
A list of associations, each of which has:
- name: name of the association to set;
- id1: object identifier 1;
- id2: object identifier 2;
- data: arbitrary information stored with this association; and
- time: association creation time or a timestamp that was stored with this association.
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. |
| 200 | Permission denied. Calling application or user doesn't have enough permissions to perform the action. |
| 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. |
| 803 | Requested object is not found on server. |
| 805 | A temporary database failure happened. Usually this can be corrected by a re-try. |
