RicohAPIAuth 版本 1.0.3

RicohAPIAuth 版本 1.0.3

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布上次发布2017年6月
SwiftSwift 版本2.3
支持 SPM支持 SPM

ricohapi 维护。



RicohAPIAuth 版本 1.0.3

  • ricoh公司有限责任公司

Ricoh Auth Client for Swift

此开源库可让您将 Ricoh API 的 授权和发现服务集成到您的 Swift 应用程序中。

更多详情请访问 http://docs.ricohapi.com/

要求

  • Swift 2.2+
  • Xcode 7.3.1+

您还需要

  • Ricoh API 客户端凭证(client_id & client_secret)
  • Ricoh ID(user_id & 密码)

如果您没有,请从 THETA 开发者网站 注册您自己以及您的客户。

安装

本节显示了两种不同方法将 Ricoh Auth Client for Swift 安装到您的应用程序中。
查看 Auth Sample 以尝试 Ricoh Auth Client for Swift 的示例。

手动

  • 通过运行以下命令来克隆 Ricoh Auth Client for Swift
$ git clone https://github.com/ricohapi/auth-swift.git
  • 打开新的 auth-swift 目录,将 RicohAPIAuth.xcodeproj 拖动到您应用程序 Xcode 项目的 Project Navigator 中。

    它应该嵌套在该应用程序的蓝色项目图标之下。它是否在所有其他 Xcode 学习组之上或之下无关紧要。

  • 在 Xcode 的 scheme 菜单中选择 RicohAPIAuth scheme 并运行它。

  • 选择您的应用程序 scheme 并运行以加载 RicohAPIAuth 模块。

  • 安装完成!有关编码示例,请查看 Sample Flow

示例流程

// Import
import RicohAPIAuth

// Set your Ricoh API Client Credentials
var authClient = AuthClient(
    clientId: "<your_client_id>",
    clientSecret: "<your_client_secret>"
)

// Set your Ricoh ID
authClient.setResourceOwnerCreds(
    userId: "<your_user_id>",
    userPass: "<your_password>"
)

// Open a new session
authClient.session(){result, error in
if !error.isEmpty() {
    print("status code: \(error.statusCode)")
    print("error message: \(error.message)")
} else {
    print("access token : \(result.accessToken)")
}

SDK API 示例

构造函数

var authClient = AuthClient(
    clientId: "<your_client_id>",
    clientSecret: "<your_client_secret>"
)

设置资源所有者凭证

authClient.setResourceOwnerCreds(
    userId: "<your_user_id>",
    userPass: "<your_password>"
)

打开新会话

authClient.session(){result, error in
if error.isEmpty() {
    print("access token : \(result.accessToken)")
    // do something
}

恢复先前会话

// This method resumes a preceding session if it is closed.
authClient.getAccessToken(){result, error in
if error.isEmpty() {
    print("access token : \(result.accessToken)")
    // do something
}