Selecting a File from Up
Using this action users will be able to select an already uploaded file from their CloudApp account, or upload a new using Up's in-app upload options. Files cannot be sent to Up to process using x-callback-url, however Up does support uploading files using aUIDocumentInteractionController
.
Request URL
com.axiixc.up://x-callback-url/select-file
Required Parameters
x-success
required to return user to your application. If a cancel callback is not specified then this callback will be used without any additional parameters.
Optional Parameters
x-source
displayed as a back button in the navigation bar. Standard iOS back button truncation rules apply, if your source is too long the UI will simply display "Back".x-cancel
in the event the user cancels their selection, this callback will be used to return them to your app.types
pass a comma-seperated list of types that you want the user to be allowed to choose from. Up will only display drops of the included types, and remove the + button from the UI. Valid types include those listed on the CloudApp API Documentation and additionally two custom values. Unknown values will be ignored.up-media
include image, audio, and video drops.up-files
include all drops except bookmarks.
Response Parameters
Assuming the user did not cancel the operation, Up will invoke your callback with the following result parameters.shareURL
this is a URL appropriate for sharing with other people via services like Twitter and Text Messages.contentURL
this is a direct URL to the content of the drop.name
this is the user given name of the drop. It does not necessarily have to be a filename.type
this is the type of the drop as reported by CloudApp. Possible values conform to those listed on the CloudApp API Documentation.
Example Request
com.axiixc.up://x-callback-url/select-file?
x-success=source-app://x-callback-url/select-file-success&
x-source=Source%20App
Example Response
source-app://x-callback-url/select-file-success?
shareURL=http://cl.ly/image/1x0B462T2Q0I&
contentURL=http://cl.ly/image/1x0B462T2Q0I/image.png&
name=image.png&
type=image