We are making breaking changes to the beta sharing endpoints, which will take effect as of February 24th, 2016:
- Reorganizing some error structures
- Changing the format of shared folder IDs
These changes help make error handling more intuitive and provide a better migration path for apps still using v1 endpoints.
Error Structure Changes
We’re improving and reorganizing the error structures for the beta sharing endpoints. For apps handling errors, changes will not be backwards compatible, but they will make error handling more intuitive in the future, especially as more features are added.
[UPDATE December 11, 2015] The following breaking changes are now available in the SDKs.
We’re making some improvements to the sharing features currently in beta. Specifically, we’re introducing paging support, and a new shared folder membership endpoint. We’ve also made some changes to how member errors are reported, as well as some of the fields included in SharedFolderMetadata. These changes will not be backwards compatible, but will allow for better scalability and ease of use.
Today we’re excited to launch Dropbox API v2!
We announced a preview of API v2 in April, and have continued to update and improve the API based on your feedback. As of today, Dropbox API v2 is ready to be used in all your Dropbox-connected apps. Thank you to the hundreds of developers who have already tried out API v2 in preview.
Our goal with API v2 is to provide a simpler, more consistent, and more comprehensive API. In addition to the API itself, we’re also introducing clearer documentation,
Today we’re announcing a much-requested API endpoint: shared link metadata, which lets you get metadata (similar to Core API’s
/metadata) from Dropbox shared links. This API endpoint doesn’t require a user access token.
We’ve been working with our friends at Slack and Trello to help develop this endpoint to super-power Dropbox shared links pasted into a channel or board. We’re now looking forward to seeing how the rest of the developer community uses it.
To test this new endpoint out, you’ll need two things: a Dropbox shared link and a Dropbox app.
If you’re using the Dropbox Core SDK for iOS, there’s a small, but important, change you’ll need to make to your app to get it working with iOS 9.
iOS 9 requires your app to pre-register application schemes it intends to call. For Dropbox, you’ll need to add the scheme
dbapi-2 to your list of allowed schemes like so:
- Open your YourApp-Info.plist file and add the key,
LSApplicationQueriesSchemes, add a new item with the value
It was a dark and stormy night. Wolves howled at the full moon as all the village slept — all except for our protagonist, who stared into their computer monitor, switching between API docs and their terminal. As they reread the documentation, they had an idea, and excitedly typed in a command. But it responded with yet another syntax error. Our protagonist felt like cURLing up into a ball.
Our protagonist dreamed that, one day, there might be a tool to help developers like them. Maybe even a GUI. One day, they could use it to painlessly get an OAuth2 token.