Connector:Dropbox

classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

Connector:Dropbox

indika prasad
This post was updated on .
Introduction

Dropbox is a file hosting service operated by Dropbox, Inc., that offers cloud storage, file synchronization, and client software. Dropbox allows users to create a special folder on each of their computers, which Dropbox then synchronizes so that it appears to be the same folder (with the same contents) regardless of which computer is used to view it. Files placed in this folder also are accessible through a website and mobile phone applications.

Dropbox integration support for 3 types of API
        1. Datastore API
        2. Sync API
        3. Core API
        But sync API is only for mobile devises and no http interface.

Connector Summery
      • Connector Name:  dropbox-connector
      • Version: 1.0.0
      • Technology:  REST
      • API Version:  v1.0
      • API URL: https://api.dropbox.com

Authentication
oauth2 access token use to access the API [1]

Selected Methods (26) for version 1.0.0
      • init- config operation.
      • getUserInfo - Retrieves information about the user's account.
      • getFile - Downloads a file.
      • uploadFile - Uploads a file using PUT semantics.
      • getMetadata - Retrieves file and folder metadata.
      • getDeltaEntires - A way of letting keep up with changes to files and folders in a user's Dropbox.
      • getMetadataForPreviousRevision - Obtains metadata for the previous revisions of a file.
      • rollbackToPreviousRevision - Restores a file path to a previous revision. Unlike downloading a file at a given revision and then re-uploading it, this call is atomic. It also saves a bunch of bandwidth.
      • getMetadataBySearch - Returns metadata for all files and folders whose filename contains the given search string as a substring.
      • getShareLink - Creates and returns a Dropbox link to files or folders users can use to view a preview of the file in a web browser.
      • getMediaLink - Returns a link directly to a file.
      • getCopyFileRef - A copy_ref to the specified file. For compatibility reasons, it returns the link's expiration date in Dropbox's usual date format. All links are currently set to expire far enough in the future so that expiration is effectively not an issue.
      • getThumbnail - Gets a thumbnail for an image    
      • chunkUpload - Completes an upload initiated by the /chunked_upload method. Saves a file uploaded via /chunked_upload to a user's Dropbox.
      • chunkUploadCommit - Completes an upload initiated by the /chunked_upload method. Saves a file uploaded via /chunked_upload to a  user's Dropbox.
      • copyFile - Copies a file or folder to a new location.
      • createFolder - Creates a folder.
      • deleteFile - Deletes a file or folder.
      • moveFile - Moves a file or folder to a new location.
      • getDataStore - Retrieves a list of all datastores for the current user.
      • isValidDataStore - Checks the validity of a datastore ID and returns its revision and handle. The ID must refer to an existing datastore. This works for both local and global datastores..
      • getOrCreateDatastore - Checks the validity of a local datastore ID or creates a new datastore with the given ID, and returns its revision and handle. This only works for local datastores. To create a global datastore, use create_datastore.
      • createDatastore - Creates a new "global" datastore and returns its revision and handle. If the datastore already exist and is owned  by the same user, this call returns its revision and handle. If the datastore already exists and is owned by another user, this call returns an error. To create a local datastore, use get_or_create_datastore.
      • deleteDatastore - Remove a datastore.
      • getDelta - Return deltas for a datastore since a given revision.
      • getSnapshot - Return a full snapshot of a datastore.



[1] https://www.dropbox.com/1/oauth2/authorize
Reply | Threaded
Open this post in threaded view
|

Re: Connector:Dropbox

malakasilva
Please provide what is the API reference used? 




On Mon, Jan 20, 2014 at 9:19 PM, indika prasad <[hidden email]> wrote:
*Introduction*

Dropbox is a file hosting service operated by Dropbox, Inc., that offers
cloud storage, file synchronization, and client software. Dropbox allows
users to create a special folder on each of their computers, which Dropbox
then synchronizes so that it appears to be the same folder (with the same
contents) regardless of which computer is used to view it. Files placed in
this folder also are accessible through a website and mobile phone
applications.

Dropbox integration support for 3 types of API
        1. Datastore API
        2. Sync API
        3. Core API
        But sync API is only for mobile devises and no http interface.

*Connector Summery*
      • Connector Name:  dropbox-connector-1.0.0
      • Version: 1.0.0
      • Technology:  REST
      • API Version:  v1.0
      • API URL: https://api.dropbox.com

*Authentication*
oauth2 access token use to access the API [1]

Selected Methods (26) for version 1.0.0
      • init- config operation.
      • getUserInfo - Retrieves information about the user's account.
      • getFile - Downloads a file.
      • uploadFile - Uploads a file using PUT semantics.
      • getMetadata - Retrieves file and folder metadata.
      • getDeltaEntires - A way of letting keep up with changes to files and
folders in a user's Dropbox.
      • getMetadataForPreviousRevision - Obtains metadata for the previous
revisions of a file.
      • rollbackToPreviousRevision - Restores a file path to a previous
revision. Unlike downloading a file at a given revision and then
re-uploading                            it, this call is atomic. It also saves a bunch of
bandwidth.
      • getMetadataBySearch - Returns metadata for all files and folders
whose filename contains the given search string as a substring.
      • getShareLink - Creates and returns a Dropbox link to files or
folders users can use to view a preview of the file in a web browser.
      • getMediaLink - Returns a link directly to a file.
      • getCopyFileRef - A copy_ref to the specified file. For compatibility
reasons, it returns the link's expiration date in Dropbox's usual date
format. All links are currently set to expire far enough in the future so
that expiration is effectively not an issue.
      • getThumbnail - Gets a thumbnail for an image
      • chunkUpload - Completes an upload initiated by the /chunked_upload
method. Saves a file uploaded via /chunked_upload to a user's Dropbox.
      • chunkUploadCommit - Completes an upload initiated by the
/chunked_upload method. Saves a file uploaded via /chunked_upload to a
user's Dropbox.
      • copyFile - Copies a file or folder to a new location.
      • createFolder - Creates a folder.
      • deleteFile - Deletes a file or folder.
      • moveFile - Moves a file or folder to a new location.
      • getDataStore - Retrieves a list of all datastores for the current
user.
      • isValidDataStore - Checks the validity of a datastore ID and returns
its revision and handle. The ID must refer to an existing datastore. This
works for both local and global datastores..
      • getOrCreateDatastore - Checks the validity of a local datastore ID
or creates a new datastore with the given ID, and returns its revision and
handle. This only works for local datastores. To create a global datastore,
use create_datastore.
      • createDatastore - Creates a new "global" datastore and returns its
revision and handle. If the datastore already exist and is owned  by the
same user, this call returns its revision and handle. If the datastore
already exists and is owned by another user, this call returns an error. To
create a local datastore, use get_or_create_datastore.
      • deleteDatastore - Remove a datastore.
      • getDelta - Return deltas for a datastore since a given revision.
      • getSnapshot - Return a full snapshot of a datastore.



[1] https://www.dropbox.com/1/oauth2/authorize




--
View this message in context: http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-Dropbox-tp90884.html
Sent from the WSO2 Architecture mailing list archive at Nabble.com.
_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture



--

Best Regards,

Malaka Silva
Senior Tech Lead
M: +94 777 219 791
Fax :94 11 2145300 
LinkedIn : http://www.linkedin.com/pub/malaka-silva/6/33/77

WSO2, Inc. 
lean . enterprise . middleware 
http://www.wso2.com/

Save a tree -Conserve nature & Save the world for your future. Print this email only if it is absolutely necessary.

_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
Reply | Threaded
Open this post in threaded view
|

Re: Connector:Dropbox

Ramindu Deshapriya
Reply | Threaded
Open this post in threaded view
|

Re: Connector:Dropbox

Jackie Wheeler
Please note that the connector should be named dropbox-connector, not dropbox-connector-1.0.0 (our convention is not to include the version in the connector name).

Thanks,
Jackie


On Thu, Jan 23, 2014 at 9:21 AM, Ramindu Deshapriya <[hidden email]> wrote:
Hi,

Datastore API: https://www.dropbox.com/developers/datastore/docs/http
Core API: https://www.dropbox.com/developers/core/docs

Thanks.



--
View this message in context: http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-Dropbox-tp90884p91162.html
Sent from the WSO2 Architecture mailing list archive at Nabble.com.
_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture



--
Jackie Wheeler
VP, Technical Content
WSO2, Inc.  
Mobile: +1 510 725-2876

_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
Reply | Threaded
Open this post in threaded view
|

Re: Connector:Dropbox

Jackie Wheeler
Malaka just pointed out that we don't use "-connector" in the name either. So here's clarification on connector naming, using the JIRA connector as an example:
  • The ZIP file containing the connector is: jira-connector-1.0.0.zip
  • The connector component name is "jira", so when configuring operations on the connector, the prefix is just "jira", such as: jira.init
We should follow this convention with all connectors.

Thanks,
Jackie


On Thu, Jan 23, 2014 at 4:01 PM, Jackie Wheeler <[hidden email]> wrote:
Please note that the connector should be named dropbox-connector, not dropbox-connector-1.0.0 (our convention is not to include the version in the connector name).

Thanks,
Jackie


On Thu, Jan 23, 2014 at 9:21 AM, Ramindu Deshapriya <[hidden email]> wrote:
Hi,

Datastore API: https://www.dropbox.com/developers/datastore/docs/http
Core API: https://www.dropbox.com/developers/core/docs

Thanks.



--
View this message in context: http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-Dropbox-tp90884p91162.html
Sent from the WSO2 Architecture mailing list archive at Nabble.com.
_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture



--
Jackie Wheeler
VP, Technical Content
WSO2, Inc.  
Mobile: <a href="tel:%2B1%20510%20725-2876" value="+15107252876" target="_blank">+1 510 725-2876



--
Jackie Wheeler
VP, Technical Content
WSO2, Inc.  
Mobile: +1 510 725-2876

_______________________________________________
Architecture mailing list
[hidden email]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture