如何用OAuth发送GET请求？解决Arduino Cloud API连接报错

一、报错原因分析与修复 #

1. 第17行：OAuth2Swift初始化参数错误 #

Arduino Cloud API采用客户端凭证授权模式（Client Credentials Flow），不需要authorizeUrl和responseType参数，原代码中多余的参数导致初始化报错，需调整初始化逻辑适配该授权模式。

2. 第22行：get请求参数不匹配 #

最新版本OAuthSwift的client.get方法已调整参数结构，不再拆分success和failure闭包，需使用统一的completionHandler，同时必须指定connectionHandler参数（可传.default）。

3. 第28行：顶层表达式违规 #

Swift不允许在文件根级别直接执行变量初始化和函数调用（脚本场景除外），需将调用代码放入应用入口类或视图控制器的作用域内。

二、完整修复后的代码 #

import OAuthSwift
import Foundation

class ArduinoCloudAPI {
    private let oauthSwift: OAuth2Swift
    private let accessTokenKey = "ArduinoCloudAccessToken"
    
    init() {
        // 适配Client Credentials模式初始化OAuth2Swift
        oauthSwift = OAuth2Swift(
            consumerKey: "YOUR_CONSUMER_KEY",
            consumerSecret: "YOUR_CONSUMER_SECRET",
            authorizeUrl: "",
            accessTokenUrl: "https://api2.arduino.cc/iot/v1/clients/token",
            responseType: ""
        )
        // 设置AccessToken请求的必要头信息
        oauthSwift.client.accessTokenRequest.headers = ["Content-Type": "application/x-www-form-urlencoded"]
    }
    
    // 获取AccessToken（Client Credentials模式）
    private func fetchAccessToken(completion: @escaping (String?, Error?) -> Void) {
        oauthSwift.client.credentials = OAuthSwiftCredential(consumerKey: oauthSwift.consumerKey, consumerSecret: oauthSwift.consumerSecret)
        
        oauthSwift.client.getOAuthAccessToken(
            withParams: ["grant_type": "client_credentials"],
            headers: nil,
            success: { credential, _, _ in
                // 持久化Token，避免重复请求
                UserDefaults.standard.set(credential.oauthToken, forKey: accessTokenKey)
                completion(credential.oauthToken, nil)
            },
            failure: { error in
                completion(nil, error)
            }
        )
    }
    
    // 获取指定Thing的属性
    func fetchThingProperties(thingId: String) {
        // 优先读取已保存的Token
        if let savedToken = UserDefaults.standard.string(forKey: accessTokenKey) {
            oauthSwift.client.credential.oauthToken = savedToken
            performGetRequest(thingId: thingId)
        } else {
            // 无Token则先获取
            fetchAccessToken { [weak self] token, error in
                guard let self = self, let token = token else {
                    print("获取AccessToken失败: \(error?.localizedDescription ?? "未知错误")")
                    return
                }
                self.oauthSwift.client.credential.oauthToken = token
                self.performGetRequest(thingId: thingId)
            }
        }
    }
    
    // 执行GET请求
    private func performGetRequest(thingId: String) {
        let propertiesUrl = "https://api2.arduino.cc/iot/v1/things/\(thingId)/properties"
        
        oauthSwift.client.get(
            propertiesUrl,
            parameters: nil,
            headers: ["Authorization": "Bearer \(oauthSwift.client.credential.oauthToken)"],
            connectionHandler: .default,
            completionHandler: { result in
                switch result {
                case .success(let response):
                    if let dataString = response.string {
                        print("获取属性成功:\n\(dataString)")
                    } else {
                        print("无法解析响应数据")
                    }
                case .failure(let error):
                    print("请求失败: \(error.localizedDescription)")
                }
            }
        )
    }
}

// 应用入口调用示例（适配iOS/macOS App结构）
@main
struct ArduinoCloudDemoApp: App {
    init() {
        let arduinoAPI = ArduinoCloudAPI()
        arduinoAPI.fetchThingProperties(thingId: "9224968a-5263-4f3a-b552-94a2f3dfa69e")
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

三、关键实现说明 #

1. 客户端凭证模式适配：针对Arduino Cloud API的授权规则，省略不必要的授权URL参数，直接通过客户端密钥获取Token。
2. Token持久化：将Token保存到UserDefaults，减少重复的Token请求，提升效率。
3. 请求头规范：获取Token时设置Content-Type，请求资源时携带Authorization Bearer头，符合API要求。
4. 代码合规性：将调用逻辑移至@main应用结构体的初始化方法，遵循Swift代码作用域规范。

四、OAuth发送GET请求通用步骤 #

以Arduino Cloud为例，通用流程如下：

• 初始化OAuth客户端，配置客户端ID、密钥及Token请求地址。
• 通过对应授权模式（如客户端凭证）获取AccessToken。
• 在GET请求的请求头中携带Authorization: Bearer {token}。
• 发送请求并通过结果枚举处理成功/失败场景。

内容的提问来源于stack exchange，提问作者Tali Mosley