Class

SLRequest

An object that you use to assemble an HTTP request for communicating with a social media service.

Declaration

@interface SLRequest : NSObject

Overview

The SLRequest object encapsulates the properties of an HTTP request, providing a convenient template for you to make requests. You send a request to a social networking service to perform some operation on behalf of the user or to retrieve user information.

HTTP requests have these common components: an HTTP request method (GET, POST, PUT, or DELETE), a URL identifying the operation to perform, a set of query parameters, and an optional multipart POST body that contains additional data. The values for these properties depend on the request you are sending and the target service provider. Refer to each supported social networking site’s documentation for possible values. Links to documentation are provided in Table 1.

Use the requestForServiceType:requestMethod:URL:parameters: method to initialize a newly created SLRequest object passing the required property values. Use the addMultipartData:withName:type: to optionally specify a multipart POST body. After you create your request, use the performRequestWithHandler: method to send the request, specifying the handler to call when the request is done.

If you already have a sending mechanism, you can use the preparedURLRequest method to create the request that you send using an NSURLConnection object. If the request requires user authorization, set the account property to an ACAccount object.

Table 1

Social Services Individual Documentation Sites

Topics

Initializing Requests

+ requestForServiceType:requestMethod:URL:parameters:

Initializes a newly created request object with the specified properties.

Sending a Request

- performRequestWithHandler:

Performs an asynchronous request and calls the specified handler when done.

SLRequestHandler

The callback handler for a request.

Providing User Credentials

account

Account information used to authenticate the request.

Getting the Request Details

- preparedURLRequest

Returns an authorized URL request that can be sent using an NSURLConnection object.

requestMethod

The method to use for this request.

SLRequestMethod

Indicates the request method used in the request.

URL

The destination URL for this request.

parameters

The parameters for this request.

Adding Data to the Request

- addMultipartData:withName:type:filename:

Specifies a named multipart POST body for this request.

- addMultipartData:withName:type:

Specifies a named multipart POST body for this request.

Deprecated

Relationships

Inherits From