STLOAuthClient = AFNetwork + OAuth 1.0a

这是什么？

一个使用AFNetwork，启用ARC的OAuth 1.0a客户端。

它工作吗？

它已被Twitter、Readability和Tumblr API进行测试。

我赶时间（TLDR模式），你能用三句话解释吗？

添加AFNetwork和两个文件，调用 - setConsumerKey:secret: 和 - setAccessToken:secret 来设置签名参数，之后所有的调用都将进行签名。如果您想要非认证的调用，可以使用 - unsignedRequestWithMethod:path:parameters: 或 - setSignRequests(NO)。

如何安装？

安装AFNetwork并添加两个文件 STLOAuthClient.m 和 STLOAuthClient.h。

好了，现在它已安装并且正确编译，如何使用它？

1. 首先要做的是为新的对象提供 consumerKey 和 consumerSecret（由服务提供的值），您可以使用 - initWithBaseURL:consumerKey:secret:（它是一个指定初始化器）或 - setConsumerKey:secret:；
2. 使用 - getPath:parameters:success:failure:、- postPath:parameters:success:failure:、- putPath:parameters:success:failure:、- deletePath:parameters:success:failure: 或 - requestWithMethod:path:parameters: 进行调用；
3. 有一个名为 signRequests 的布尔属性，允许您控制何时对请求进行签名或不在，但您也可以使用 - unsignedRequestWithMethod:path:parameters: / - signedRequestWithMethod:path:parameters:；
4. 如果您需要设置区域，有一个名为 realm 的属性。如果您不设置它，它将假设 baseURL 的值。

示例？

当然是

STLOAuthClient *client = [[STLOAuthClient alloc] initWithBaseURL:[NSURL URLWithString:@"https://www.readability.com/api/rest/v1/"]];
[client setConsumerKey:CONSUMER_KEY secret:CONSUMER_SECRET];
NSDictionary *params = [NSDictionary dictionaryWithObjectsAndKeys:
                        username, @"x_auth_username", 
                        password, @"x_auth_password",
                        @"client_auth", @"x_auth_mode",
                        nil];

[client getPath:@"oauth/access_token/" parameters:params success:^(AFHTTPRequestOperation *operation, id responseObject) {
  NSLog(@"SUccess %@", operation.responseString);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
  NSLog(@"Failure, %@", error);
}];

在 '-' 后面加空格到底有什么用吗？

嗨，我喜欢它，不要改变它。

许可证？

BSD。

感谢（以及额外的许可证）

有一些函数/方法基于第三方代码

• ASIHTTPRequest+OAuth.m——由Scott James Remnant于2011年6月1日创建。
• NSString+URLEncode.h —— 由Scott James Remnant于2011年6月1日创建。
• AFOAuth2Client.m —— 版权所有（c）2011 Mattt Thompson（《http://mattt.me/》）。