Dropbox

Introduction

By using the Carriots External API, you can access the files that you have stored in your Dropbox and get their URLs. Can you imagine the possibilities of this?.

We came up with the idea of making a stuffed toy, connecting it to Carriots and reproducing our videos from Dropbox in a screen (demo Domokun).

To use Dropbox with Carriots, the first step you have to do is link both accounts.

 

How to use

List

Dropbox files list

URL: http://api.carriots.com/external/dropbox/user/-- username --/
HTTP method: GET
Response: json/xml

Parameters:

Attribute Description
op (mandatory) Allowed values:
- all (returns all files)
- newest (returns all files ordered by descending date)
- oldest (returns all files ordered by ascending date)
- random (returns a shuffled list of files)
name (optional) Filter by filename

Response codes

Code Description
200 Operation successfull
400 Request not valid
401 Unauthorized

 

Examples

For these examples we have 3 files (2 videos + 1 image) in a Dropbox account linked with Carriots.

Get all files URLs in JSON format
  • HTTP request

    GET http://api.carriots.com/external/dropbox/user/exampleuser/?op=all
    carriots.apikey: YOUR APIKEY HERE

  • Response
  • hurl screenshot
    • Get all files
Get all files in XML format
  • HTTP request

    GET http://api.carriots.com/external/dropbox/user/exampleuser/?op=all
    carriots.apikey: YOUR APIKEY HERE
    accept: application/xml

  • Response
  • hurl screenshot
    • Get all videos
Get all files named Domo-kun in JSON format
  • HTTP request

    GET http://api.carriots.com/external/dropbox/user/exampleuser/?op=all&name=Domo-kun
    carriots.apikey: YOUR APIKEY HERE

  • Response
  • hurl screenshot
    • Get Domo-kun file