- Yandex Disk is a cloud storage service with 26 million users storing 6 billion files totaling 14 million added per day. It offers 10GB of free storage that can be increased through invites or partner offers. - It has clients for web, desktop, mobile, and 3rd parties via SDKs, WebDAV, and a REST API. The REST API allows more functionality than WebDAV like managing public files and the trash. - The document provides code examples for implementing a Disk class in Swift to interface with the Yandex Disk REST API, including uploading and deleting files. It emphasizes best practices like test-driven development.

2. REST ing with
the new
Yandex.Disk API
Clemens Auer
Developer

3. What Is Yandex Disk?

4. What Is Yandex Disk?
- 26 Million registered Disk users.
- 6 Billion files.
- 14 Million files added per day.

5. What Is Yandex Disk?
How much storage space users get for free?
- Basic: 10 GB.
- Invites: up to 10 GB.
- Partner offers: currently up to 50 GB.

6. What Is Yandex Disk?
For those who need more:
Storage 10 GB 100 GB 1 TB
per month 30 RUB 150 RUB 900 RUB
per year 300 RUB 1500 RUB 9000 RUB

7. What Is Yandex Disk?
Clients
- Web: disk.yandex.ru, widgets.
- Desktop: Windows, Mac, Linux
- Mobile: iOS, Android, WinPhone
- 3rd party

8. What Is Yandex Disk?
3rd party clients.
- Official SDKs (JAVA, Obj-C, C#)
- WebDAV + extensions
- REST API

9. WebDAV vs. REST API

10. WebDAV vs. REST API
WebDAV REST
Upload ✓ ✓
Download ✓ ✓
Create Folder ✓ ✓
Copy ✓ ✓
Move ✓ ✓
Delete ✓ ✓
List ✓ ✓

11. WebDAV vs. REST API
Support for public files
WebDAV REST
Share ✓ ✓
Unshare ✓ ✓
List Metadata ✗ ✓
Download ✗ ✓
Save to Disk ✗ ✓

12. WebDAV vs. REST API
Working with the trash
WebDAV REST
List ✗ ✓
Delete ✗ ✓
Restore ✗ ✓

13. WebDAV vs. REST API
What is missing?
WebDAV REST
Basic Auth ✓ ✗
Free/Used Space ✓ ✗*
Hash Upload ✓ ✗
Custom Props ✓ ✗
Userinfo ✓ ✗

14. Getting Started
- Register application
- Register dev accounts
- Get token for development
- Полигон
- Code

15. Register application

16. Register application

17. Register application

18. Register application

19. Register application

20. Register dev accounts.

21. https://oauth.yandex.ru/authorize?response_type=token&client_id=
Get token for development

22. https://oauth.yandex.ru/verification_code?dev=True#
access_token=d8edc4f3a698473fbc87634c41b2ca81
&token_type=bearer
&state=
&expires_in=31536000
Get token for development

23. Полигон

24. Getting Started
- Register application
- Register dev accounts
- Get token for development
- Полигон
- Code

25. Code example
What we try to achieve:
import Foundation
!
public class Disk {
…
}
!
let disk = Disk(token: "d8edc4f3a698473fbc87634c41b2ca81")
var fileURL : NSURL
!
disk.uploadURL(fileURL, toPath: fileURL.lastPathComponent, overwrite: true) {
// handle errors
}
!
disk.deletePath(fileURL.lastPathComponent, permanently: false) {
// handle response
}

26. Code example
Basic properties in Disk class
public class Disk {
public let token : String
public let baseURL = "https://cloud-api.yandex.net:443"
!
var additionalHTTPHeaders : [String:String] {
return [
"Accept" : "application/json",
"Authorization" : "OAuth (token)",
"User-Agent" : "Mobile Camp Demo"
]
}
}

27. Code example
Complete basic Disk class
public class Disk {
public let token : String
public let baseURL = "https://cloud-api.yandex.net:443"
!
var additionalHTTPHeaders : [String:String] {
return [
"Accept" : "application/json",
"Authorization" : "OAuth (token)",
"User-Agent" : "Mobile Camp Demo"
]
}
!
public lazy var session : NSURLSession = {
let config = NSURLSessionConfiguration.defaultSessionConfiguration()
config.HTTPAdditionalHeaders = self.additionalHTTPHeaders
!
return NSURLSession(configuration: config)
}()
!
public init(token:String) {
self.token = token
}
}

28. Code example
Disk extension for de-serializing JSON data
extension Disk {
class func JSONDictionaryWithData(data:NSData!, onError:(NSError!)->Void)
-> NSDictionary? {
!
var error: NSError?
let root = NSJSONSerialization.JSONObjectWithData(data,
options: nil, error: &error) as? NSDictionary
!
if root == nil {
onError(NSError(…))
return nil
}
!
return root
}
}

29. Code example
NSURLSessing extension for doing JSON requests
extension NSURLSession {
func jsonTaskWithMethod(method:String, url: NSURL!, onError: ((NSError!) -> Void)!,
onCompletion: ((NSDictionary, NSHTTPURLResponse) -> Void)!)
-> NSURLSessionDataTask! {
!
let request = NSMutableURLRequest(URL: url)
request.HTTPMethod = method
!
return dataTaskWithRequest(request) {
(data, response, error) -> Void in
!
let jsonRoot = Disk.JSONDictionaryWithData(data, onError: onError)
!
if let jsonRoot = jsonRoot {
switch response.statusCode {
case 400...599:
return onError(…)
default:
return onCompletion(jsonRoot, response)
}
} else {
return // handler already called from JSONDictionaryWithData
}
}
}
}

30. Take a peek at the documentation

31. Code example
Disk extension for processing common JSON object
extension Disk {
class func hrefMethodTemplatedWithDictionary(dict:NSDictionary?)
-> (href:String, method:String, templated:Bool) {
var href = ""
var method = ""
var templated = false
!
if let json = dict {
if let str = json["href"] as? String {
href = str
}
if let str = json["method"] as? String {
method = str
}
if let nr = json["templated"] as? NSNumber {
templated = nr.boolValue
}
}
!
return (href, method, templated)
}
}

32. Code example
Disk extension implementing file upload
extension Disk {
public func uploadURL(fileURL:NSURL, toPath path:String, overwrite:Bool?,
handler:(NSError!) -> Void) -> Void {
!
var url = "(baseURL)/v1/disk/resources/upload?path=(path.urlEncoded())"
!
if let overwrite = overwrite {
url += "&overwrite=(overwrite)"
}
let error = { handler($0) }
!
session.jsonTaskWithMethod("GET", url: NSURL(string: url), onError: error) {
(jsonRoot, response)->Void in
!
let (href, method, templated) = Disk.hrefMethodTemplatedWithDictionary(jsonRoot)
!
let request = NSMutableURLRequest(URL: NSURL(string: href))
request.HTTPMethod = method
!
self.session.uploadTaskWithRequest(request, fromFile: fileURL) {
(data, response, trasferError)->Void in
!
return error(trasferError)
}.resume()
}.resume()
}
}

33. Take another peek at the documentation

34. Code example
Disk extension implementing delete.
public enum DeletionResult {
case Done
case InProcess(href:String, method:String, templated:Bool)
case Failed(NSError!)
}
!
extension Disk {
public func deletePath(path:String, permanently:Bool?,
handler:(result:DeletionResult) -> Void) -> Void {
var url = "(baseURL)/v1/disk/resources?path=(path.urlEncoded())"
!
if let permanently = permanently {
url += "&permanently=(permanently)"
}
let error = { handler(result: .Failed($0)) }
!
session.jsonTaskWithMethod("DELETE", url: NSURL(string: url), onError: error) {
(jsonRoot, response)->Void in
switch response.statusCode {
case 202:
return handler(result: .InProcess(Disk.hrefMethodTemplatedWithDictionary(jsonRoot)))
case 204:
return handler(result: .Done)
default:
return error(NSError(…))
}
}.resume()
} }

35. Lessons Learned
Swift
- enum, switch, closures, tuples
- Type safety vs. Obj-C weak typing
- Volatile: Xcode release notes.
- Apple Dev Forums

36. Lessons Learned
REST API
- Documentation vs. Полигон
- Fast
- OAuth
- Roadmap ahead

37. Lessons Learned
In general
- Test driven development saves time.
- Autotest the API version
- Report bugs
http://feedback2.yandex.ru/disk/api/

38. References
https://oauth.yandex.ru
https://oauth.yandex.ru/client/new
http://api.yandex.ru/disk/
http://api.yandex.ru/login/
https://yadi.sk/d/5b9BoUjtZvJhp

39. Clemens Auer
Developer
aucl@yandex.ru
aucl@yandex-team.ru
Thank you