sequencing-master-plugin-api-objc 1.4.1

sequencing-master-plugin-api-objc 1.4.1

测试已测试
语言语言 Obj-CObjective C
许可 MIT
发布上次发布2017年3月

Bogdan Laukhin维护。



 
依赖
sequencing-oauth-api-objc~> 2.0.5
sequencing-file-selector-api-objc~> 1.3.2
sequencing-app-chains-api-objc~> 1.1.1
 

  • Sequencing

Master CocoaPod 插件,用于将 Sequencing.com 的实时个性化技术添加到 Objective-C 编码的 iOS 应用中

此 Master CocoaPod 插件可用于快速将 实时个性化 添加到您的应用中。此 Master 插件包含一个可定制的端到端即插即用解决方案,快速将所有必要的代码(OAuth2、文件选择器和应用链编码)添加到您的应用中。

一旦将此 Master 插件添加到您的应用中,您需要做的就是

  1. 添加您的 OAuth2 密钥
  2. 添加一个或多个 应用链编号
  3. 根据每个 应用链的可能的响应 配置您的应用

要将实时个性化技术编码到应用中,开发者可以在 Sequencing.com 上免费注册账号。免费注册账号。带有 RTP 的应用开发总是免费的。

Master 插件也有以下语言的版本

Master 插件 - 即插即用示例(此代码可以用作现成解决方案,快速将实时个性化技术添加到您的应用中)

目录

  • 实现
  • Master CocoaPod 插件安装
  • 身份验证流程
  • OAuth CocoaPod 插件集成
  • 文件选择器 CocoaPod 插件集成
  • AppChains CocoaPod 插件集成
  • 资源
  • 维护者
  • 贡献

实现

要实现此 Master 插件到您的应用中

1) 在 这里注册 免费账号

2) 将此 Master 插件添加到您的应用

3) 生成 OAuth2 密钥 并将其插入插件

4) 添加一个或多个 应用链编号。应用链会提供基于基因的信息,您可以使用这些信息来个性化您的应用。

5) 根据每个应用链的可能响应配置您的应用

配置 Master CocoaPod 插件

  • 请参阅CocoaPods指南
  • 在您的项目目录中创建 Podfile:$ pod init
  • 在 Podfile 中指定 "sequencing-master-plugin-api-objc" 的 pod 参数

    pod 'sequencing-master-plugin-api-objc', '~> 1.4.1'

  • 在您的项目中安装依赖项:$ pod install

  • 始终打开 Xcode 的工作空间而不是项目文件:$ open *.xcworkspace
  • 结果,您将安装 3 个 CocoaPod 插件:OAuth、文件选择器和 AppChains

身份验证流程

Sequencing.com 使用标准的 OAuth 方法,这使得应用能够从第三方应用那里以不暴露用户密码的方式获取对 HTTP 服务上用户帐户的有限访问。OAuth 作为代表最终用户的中间人,向服务提供访问令牌,以授权共享特定帐户信息。

Authentication sequence diagram

步骤

步骤 1:授权代码链接

首先,用户会通过授权代码链接打开一个网页

https://sequencing.com/oauth2/authorize?redirect_uri=REDIRECT_URL&response_type=code&state=STATE&client_id=CLIENT_ID&scope=SCOPES

以下是链接组件的解释

  • https://sequencing.com/oauth2/authorize - API 授权端点
  • redirect_uri=REDIRECT_URL - 授权代码授予后,服务将用户代理重定向到此处
  • response_type=code - 指定您的应用程序正在请求授权代码授权
  • state=STATE - 存储随机验证代码,将在响应中与同一代码进行比较,以验证响应是否已欺骗
  • client_id=CLIENT_ID - 应用程序的客户端 ID(API如何标识应用程序)
  • scope=CODES 指定应用程序请求的访问级别

login dialog

步骤 2:用户授权应用

用户必须首先登录到服务,以验证其身份(除非他们已经登录)。然后服务将提示用户授权或拒绝应用访问其帐户。以下是一个授权应用的示例提示

grant dialog

步骤 3:应用接收授权代码

当用户点击“授权应用”时,服务将打开在授权请求中指定的 redirect_URI URL 地址。在此 iOS 应用程序中,使用了以下的 redirect_uri

authapp://Default/Authcallback

当您的应用程序检测到 redirect_uri 页面被打开时,它应该分析将带有状态验证代码的服务器响应。如果状态验证代码与授权请求中发送的代码匹配,则表示服务器响应是有效的。现在我们可以从服务器响应中获取授权代码。

步骤 4:应用请求访问令牌

应用程序通过将授权代码(如上所述从服务器响应中获得)以及包括客户端密钥在内的身份验证详情,连同到 API 令牌端点。以下是对 Sequencing.com 令牌端点的示例 POST 请求

https://sequencing.com/oauth2/token

以下 POST 参数必须发送

  • grant_type='authorization_code'
  • code=AUTHORIZATION_CODE(AUTHORIZATION_CODE 是从 sequencing.com 重定向的结果中的 "code" 参数中获得的代码)
  • redirect_uri=REDIRECT_URL(REDIRECT_URL 与步骤 1 中使用的 URL 相同)

步骤 5: 应用程序接收访问令牌

如果授权有效,API 将向应用程序发送包含令牌对象的 JSON 响应。令牌对象包含 accessToken、其过期日期、tokenType、作用域和refreshToken。

OAuth CocoaPod 插件集成

请参阅 OAuth CocoaPod 插件文档(ObjC)

文件选择器 CocoaPod 插件集成

请参阅文件选择器 CocoaPod 插件文档(ObjC)

AppChains CocoaPod 插件集成

请参阅 AppChains CocoaPod 插件文档(ObjC)

资源

维护者

此存储库由 Sequencing.com 热情维护。如果您需要更多信息或只是想打个招呼,请发送邮件至 [email protected]

贡献

我们鼓励您热切地分支。如果您有兴趣更新主分支,请向我们发送拉取请求。如果更改有积极贡献,我们将让它继续。