Steven 361c4d655a nothing 1 month ago
..
KS3YunSDK 361c4d655a nothing 1 month ago
LICENSE 361c4d655a nothing 1 month ago
README.md 361c4d655a nothing 1 month ago

README.md

KS3 SDK for iOS

之前仓库不再使用了 后续会转移到这个仓库~

安装

通过 CocoaPods

pod "iOS-KS3SDK", "~>1.0.6"

使用方法

首先需要初始化KS3Client。可以利用AccessKeyID、AccessKeySecret初始化(由于AccessKeySecret要放在客户端,因此不安全,仅建议测试时使用),代码如下:


    [[KS3Client initialize] connectWithAccessKey:strAccessKey withSecretKey:strSecretKey];

第二种方式利用token(应用层API返回的)进行请求,每次需要调用SDK的API时都需要使用请求一次token,然后用这个token初始化KS3Request的strKS3Token,再进行API请求(推荐使用),对应的代码如下:


	[YourAppServer sendAsynchronousRequest:tokenRequest queue:[NSOperationQueue currentQueue] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
	    if (connectionError == nil) {
	        NSString *strToken = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
                //此处填写token(会当成Authorization放在请求头)
	        ks3Request.strKS3Token = token; 
	        [[KS3Client initialize] listBuckets:(KS3ListBucketsRequest *)listBucketRequest]; // 调用KS3 API接口
            // 剩余处理
	    }
	    else {
            // 错误处理
	    }
	}];

第三种方式首先需要初始化KS3Client。可以利用(临时身份)AccessKeyID、AccessKeySecret、SecurityToken初始化,代码如下:


    [[KS3Client initialize] setCredentials:[[KS3Credentials alloc] initWithAccessKey:strAccessKey withSecretKey:strSecretKey withSecurityToken:securityToken]];

服务端签名计算方法参考:API接口文档

API详细使用方法参考 https://docs.ksyun.com/documents/968

示例代码

代码许可

Apache License, Version 2.0。详情见 License 文件.