Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Социальная ссылка платформы ссылка класса SLRequest

Опции
Развертывание Target:

На этой странице
Язык:

SLRequest

Наследование


Соответствует


Оператор импорта


Swift

import Social

Objective C

@import Social;

Доступность


Доступный в iOS 6.0 и позже.

SLRequest объект инкапсулирует свойства Запроса HTTP, предоставляя удобный шаблон Вам для подачи с запросами. Вы отправляете запрос к службе социальной сети, чтобы выполнить некоторую работу от имени пользователя или получить информацию о пользователе.

Запросы HTTP имеют эти общие компоненты: метод Запроса HTTP (GET, POST, PUT или DELETE), URL, идентифицирующий работу для выполнения, ряд параметров запроса и дополнительной многослойной организации POST, содержащей дополнительные данные. Значения для этих свойств зависят от запроса, который Вы отправляете и целевой поставщик услуг. Обратитесь к документации каждого поддерживаемого сайта социальной сети для возможных значений. Ссылки к документации предоставлены в Таблице 1.

Используйте requestForServiceType:requestMethod:URL:parameters: метод для инициализации недавно создаваемый SLRequest передача объектов требуемые значения свойств. Используйте addMultipartData:withName:type: дополнительно указать многослойную организацию POST. После создания запроса используйте performRequestWithHandler: метод для отправления запроса, указывая обработчик для вызова, когда сделан запрос.

Если у Вас уже есть передающий механизм, можно использовать preparedURLRequest метод для создания запроса, что Вы отправляете использование NSURLConnection объект. Если запрос требует авторизации пользователя, установите account свойство к ACAccount объект.

Табличные 1 сайты документации частного лица социального обеспечения

Facebook

https://developers.facebook.com/docs/

Sina Weibo

http://open .weibo.com/wiki/

Twitter

https://dev.twitter.com/docs

LinkedIn

https://developer.linkedin.com/rest

  • Инициализирует недавно создаваемый объект запроса с указанными свойствами.

    Объявление

    Swift

    init!(forServiceType serviceType: String!, requestMethod requestMethod: SLRequestMethod, URL url: NSURL!, parameters parameters: [NSObject : AnyObject]!) -> SLRequest

    Objective C

    + (SLRequest *)requestForServiceType:(NSString *)serviceType requestMethod:(SLRequestMethod)requestMethod URL:(NSURL *)url parameters:(NSDictionary *)parameters

    Параметры

    serviceType

    Тип службы социальной сети. Для возможных значений посмотрите Константы Типа Службы.

    requestMethod

    Метод для использования для этого Запроса HTTP. Для возможных значений посмотрите SLRequestMethod.

    url

    Целевой URL для этого Запроса HTTP. Значения и форматирующий для URL зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    parameters

    Параметры для этого Запроса HTTP. Значения и форматирование зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Возвращаемое значение

    Недавно инициализированный объект запроса.

    Обсуждение

    Используйте этот метод для инициализации SLRequest. Значение и форматирование каждого параметра зависят от целевой службы.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • account Свойство

    Сведения об аккаунте раньше аутентифицировали запрос.

    Объявление

    Swift

    var account: ACAccount!

    Objective C

    @property(retain, nonatomic) ACAccount *account

    Обсуждение

    Учетная запись используется, чтобы подписать запрос со службами OAuth1 или добавить маркер доступа для служб OAuth2. Путем соединения учетной записи с запросом необходимые маркеры добавляются автоматически. Значение по умолчанию nil.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • requestMethod Свойство

    Метод для использования для этого запроса. (только для чтения)

    Объявление

    Swift

    var requestMethod: SLRequestMethod { get }

    Objective C

    @property(readonly, nonatomic) SLRequestMethod requestMethod

    Обсуждение

    Используйте это свойство для поиска метода Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения описаны в SLRequestMethod.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • URL Свойство

    Целевой URL для этого запроса. (только для чтения)

    Объявление

    Swift

    var URL: NSURL! { get }

    Objective C

    @property(readonly, nonatomic) NSURL *URL

    Обсуждение

    Используйте это свойство для поиска URL Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • parameters Свойство

    Параметры для этого запроса. (только для чтения)

    Объявление

    Swift

    var parameters: [NSObject : AnyObject]! { get }

    Objective C

    @property(readonly, nonatomic) NSDictionary *parameters

    Обсуждение

    Используйте это свойство для поиска параметров запроса Запроса HTTP, установленного в requestForServiceType:requestMethod:URL:parameters:. Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • Выполняет асинхронный запрос и вызывает указанный обработчик, когда сделано.

    Объявление

    Swift

    func performRequestWithHandler(_ handler: SLRequestHandler!)

    Objective C

    - (void)performRequestWithHandler:(SLRequestHandler)handler

    Параметры

    handler

    Обработчик для вызова, когда сделан запрос. Параметры для этого обработчика описаны в SLRequestHandler. Этот обработчик, как гарантируют, не вызовут ни на каком определенном потоке и не должен быть нолем.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • Возвращает авторизованный URL-запрос, который может быть отправлен с помощью NSURLConnection объект.

    Объявление

    Swift

    func preparedURLRequest() -> NSURLRequest!

    Objective C

    - (NSURLRequest *)preparedURLRequest

    Возвращаемое значение

    Совместимое с OAuth NSURLRequest объект, позволяющий приложению действовать от имени пользователя при хранении пароля пользователя частным. NSURLRequest подписывается как OAuth1 по умолчанию или OAuth2 путем добавления надлежащего маркера на основе учетной записи пользователя.

    Обсуждение

    Используйте этот метод для изменения запроса перед отправкой. Путем установки учетной записи правильно, этот метод автоматически добавит любые необходимые маркеры.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • Указывает именованную многослойную организацию POST для этого запроса.

    Объявление

    Swift

    func addMultipartData(_ data: NSData!, withName name: String!, type type: String!, filename filename: String!)

    Objective C

    - (void)addMultipartData:(NSData *)data withName:(NSString *)name type:(NSString *)type filename:(NSString *)filename

    Параметры

    data

    Данные для многослойной организации POST, такой как изображение или текст.

    name

    Имя многослойной организации POST. Это - имя, которое ожидает определенное социальное обеспечение.

    type

    Тип многослойной организации POST. Это - тип контента MIME многослойных данных.

    filename

    Имя файла присоединения, которое Вы хотите к POST. Много социального обеспечения требуют имени файла для принятия определенных запросов POST, таких как загрузка изображения или видео. Если Ваши многослойные данные не требуют имени файла, передачи в nil.

    Обсуждение

    Возможные значения параметров зависят от целевой службы. Эта информация, а также руководство на том, когда использовать многослойную организацию POST, документируется поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

Типы данных

  • Обработчик обратного вызова для запроса.

    Объявление

    Swift

    typealias SLRequestHandler = (NSData!, NSHTTPURLResponse!, NSError!) -> Void

    Objective C

    typedef void(^SLRequestHandler)(NSData *responseData, NSHTTPURLResponse *urlResponse, NSError *error);

    Обсуждение

    Параметры для этого обработчика:

    responseData

    Данные, возвращенные запросом. Формат этих данных зависит от целевой службы.

    urlResponse

    Ответ URL, возвращенный запросом, включающим Коды ответа HTTP.

    error

    Ошибочный идентификатор.

    Возможные значения зависят от целевой службы и документируются поставщиком услуг. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.

  • Возможные значения для serviceType параметр.

    Объявление

    Swift

    let SLServiceTypeFacebook: String let SLServiceTypeTwitter: String let SLServiceTypeSinaWeibo: String let SLServiceTypeTencentWeibo: String

    Objective C

    NSString *const SLServiceTypeFacebook; NSString *const SLServiceTypeTwitter; NSString *const SLServiceTypeSinaWeibo; NSString *const SLServiceTypeTencentWeibo;

    Константы

    • SLServiceTypeFacebook

      Строковая константа, идентифицирующая сайт социальной сети, Facebook.

      Доступный в iOS 6.0 и позже.

    • SLServiceTypeTwitter

      Строковая константа, идентифицирующая сайт социальной сети, Twitter.

      Доступный в iOS 6.0 и позже.

    • SLServiceTypeSinaWeibo

      Строковая константа, идентифицирующая сайт социальной сети, Sina Weibo.

      Доступный в iOS 6.0 и позже.

    • SLServiceTypeTencentWeibo

      Строковая константа, идентифицирующая сайт социальной сети, Tencent Weibo.

      Доступный в iOS 7.0 и позже.

  • Указывает метод запроса, используемый в запросе.

    Объявление

    Swift

    enum SLRequestMethod : Int { case GET case POST case DELETE case PUT }

    Objective C

    typedef NS_ENUM (NSInteger, SLRequestMethod ) { SLRequestMethodGET, SLRequestMethodPOST, SLRequestMethodDELETE, SLRequestMethodPUT; };

    Константы

    • GET

      SLRequestMethodGET

      Запрашивает информацию от указанного ресурса. Используйте запрос GET для выборки информации от указанного сервера, такого как символьные пределы или временная шкала пользователя.

      Доступный в iOS 6.0 и позже.

    • POST

      SLRequestMethodPOST

      Представляет данные, которые будут обработаны. Используйте запрос POST для представления информации к указанному серверу, такому как обновление статуса или изображение.

      Доступный в iOS 6.0 и позже.

    • DELETE

      SLRequestMethodDELETE

      Удаляет указанный ресурс.

      Доступный в iOS 6.0 и позже.

    • PUT

      SLRequestMethodPUT

      Использует запрос PUT для представления данных.

      Доступный в iOS 7.0 и позже.

    Обсуждение

    Используйте эту константу для установки requestMethod свойство. Тип запроса для использования зависит от целевой службы. Для ссылок к документации для поддерживаемых служб посмотрите Таблицу 1.

    Оператор импорта

    Objective C

    @import Social;

    Swift

    import Social

    Доступность

    Доступный в iOS 6.0 и позже.