Links.post
From Facebook Developer Wiki
Contents |
Description
Lets a user post a link on their Wall through your application. Before your application can post a link to a user's profile, the user must grant your application the share_item extended permission.
If you want a link to contain metadata or rich content like images, that metadata must be included on the page where the URL links (although for images, you can specify a URL to one image on the page being posted). See descriptions of the necessary data.
Parameters
| Required | Name | Type | Description | |
| required | api_key | string | The application key associated with the calling application. If you specify the API key in your client, you don't need to pass it with every call. | |
|---|---|---|---|---|
| optional | session_key | string | The session key of the logged in user, or the session key provided when the user granted your application the offline_access extended permission. The session key is automatically included by our PHP client. | |
| required | call_id | float | 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. If you specify the call ID in your client, you don't need to pass it with every call. | |
| sig | string | An MD5 hash of the current request and your secret key, as described in the How Facebook Authenticates Your Application. Facebook computes the signature for you automatically. | ||
| v | string | This must be set to 1.0 to use this version of the API. If you specify the version in your client, you don't need to pass it with every call. | ||
| url | string | The URL for the link. | ||
| comment | string | The comment the user included with the link. | ||
| uid | int | The user ID of the user posting the link. | ||
| optional | image | string | The absolute URL to an image on the page being posted. You can determine this URL using links.preview. If the image URL does not match one of the images on the page, or if you don't specify this parameter, the first image specified in metadata gets displayed with the post. | |
| format | string | The desired response format, which can be either XML or JSON. (Default value is XML.) | ||
| 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. |
Example Requests
$facebook->api_client->links_post('http://khaaan.com/','Best. Website. Ever.',$user_id);
Response
This method returns a link_id if successful.
Error Codes
For a complete list of error codes, see 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 | Parameter Comment is required | |
| 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. | |
| 282 | Managing shared items requires the extended permission share_item. | |
| 1500 | The url you supplied is invalid. |
Notes
- This function does not require a
session_key, unless it is being called by a desktop application. - You can call this method using a session secret, and not the application secret (for example, for a Facebook Connect site or desktop application).
