官方Objective-C XING API客户端

注意

Pod的初始版本命名为XINGAPI。这对许多用户来说很奇怪，所以我们决定将其改名为仓库XNGAPIClient。

请注意，为了兼容新的XNGAPIClient，XINGAPI Pod将不再更新。请将您的代码库切换到未来兼容模式。

如果您有任何疑问，请提出一个问题。

===

XNGAPIClient是访问XING API的官方客户端。要访问API，您只需要在https://xing.com注册一个账户，并获取可以在https://dev.xing.com获取的oauth消费者密钥和密钥。这两项都是完全免费的，只需一分钟！

XNGAPIClient建立在AFNetworking之上，因此充分利用了块的功能。我们还包含了一个示例项目，它负责将您的oauth令牌存储在密钥链中，以便您更快地开始使用。目前仅支持iOS。尚未在Mac OS X上进行测试。

开始使用

选项 1

如果您使用 CocoaPods，可以将 XNGAPIClient 存储库添加到您的 Podfile 中。然后运行 pod install 命令，XING API 客户端即可在您的项目中使用。

选项2

访问https://github.com/xing/XNGAPIClient 克隆并关注我们的仓库。

获取消费者密钥

您可以通过访问https://dev.xing.com/applications并点击创建应用按钮来获取消费者密钥和消费者密钥。

为 OAuth 身份验证设置回调 URL

您需要设置回调 URL，该 URL 可在用户通过 Safari 成功登录后调用。使用 XING API 客户端，您的回调 URL 方案将为 xingapp<YOUR CONSUMER KEY>。例如，可以是 xingapp4a568854ef676b

设置方法如下

1. 点击您的项目文件。
2. 确保选中了主目标。
3. 点击信息按钮。
4. 展开 URL 类型部分。
5. 点击加号按钮。
6. 在上文所述风格中添加您的方案

配置您的应用代理

1. 在您的应用代理中导入 #import XNGAPI.h
2. 将以下方法添加到您的应用代理中

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation
{
    if ([[XNGAPIClient sharedClient] handleOpenURL:url]) {
        return YES;
    } else {
        //insert your own handling
    }

    return NO;
}

示例用法

在共享客户端中注册您的消费者密钥和密钥

XNGAPIClient *client = [XNGAPIClient sharedClient];
client.consumerKey = @"xXxXxXxXxXxXxXxXxXxXxX";
client.consumerSecret = @"xXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxXxX";

使用OAuth登录

[client loginOAuthWithSuccess:^{
			 	// handle success
			  }
              failure:^(NSError *error) {
			 	 // handle failure
			  }];

调用以加载您的个人资料

[client getUserWithID:@"me"
           userFields:nil
              success:^(id JSON) {
			 	// handle success
			  }
              failure:^(NSError *error) {
			 	 // handle failure
			  }];

联系

德国欣地亚股份公司

• https://github.com/xing
• https://twitter.com/xingdevs
• https://dev.xing.com

许可协议

XNGAPIClient在MIT许可证下可用。有关更多信息，请参阅LICENSE文件。