XINGAPI 0.1.0

XINGAPI 0.1.0

测试测试版
语言语言 Obj-CObjective C
许可证 MIT
发布最新发布版2014年12月

未声明的维护者维护。



 
依赖项
AFNetworking~> 1.3.0
SSKeychain= 1.2.0
AFOAuth1Client= 0.3.1
 

XINGAPI 0.1.0

  • XING iOS团队

官方Objective-C XING API客户端

Build Status

XNGAPIClient是访问XING API的官方客户端。为了使用API,您只需要在https://xing.com上有一个账户,并在https://dev.xing.com上可以获得oauth消费者密钥和密钥。这两者都是完全免费的,只需一分钟!

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

入门指南

选项1

如果您使用CocoaPods,您可以将`XINGAPIClient` Pod添加到您的Podfile中。然后运行`pod install`,XING API客户端将可在您的项目中使用。

选项2

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

获取消费者密钥

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

设置OAuth认证的回调URL

为了通过OAuth认证用户,我们将切换到Safari。您需要注册一个在我们成功登录后可以重定向到的回调URL。使用XING API客户端,您的回调URL方案将为`xingapp<YOUR CONSUMER KEY>://`。一个例子将是`xingapp4a568854ef676b://`。

步骤1

通过点击您创建的应用旁边的设置图标并在《OAuth对话框/回调领域》字段中输入上述描述的回调URL方案,在《https://dev.xing.com/applications》上注册您的回调URL。

步骤2

在您的应用的Info.plist中注册相同的URL方案。

▾ 网络类型(数组)▾ 项 0(字典)URL 标识符(字符串)com.xing.xingapi ▾ 网络方案(数组)(1 项)项 0(字符串)

配置您的 App Delegate

  1. 在您的 Application Delegate 中导入 #import XNGAPIClient.h
  2. 将以下方法添加到您的 Application Delegate 中
- (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:^{
                // handle success
              }
              failure:^(NSError *error) {
                 // handle failure
              }];

联系方式

XING AG

许可证

Excel全局客户端可在 MIT 许可证下使用。有关更多信息,请参阅 LICENSE 文件。