Dropbox Notify

​

Overview

​

Auth

• schemes: [“Authorization: Bearer {value.json.access_token} on every DropboxRestApi and DropboxContentRestApi event except OAuthTokenRefresh (OAuth 2.0 access token of a scoped Dropbox app; short-lived, expires_in 14400 s)”, “OAuthTokenRefresh: POST https://api.dropboxapi.com/oauth2/token, application/x-www-form-urlencoded {value.json.form} = grant_type=refresh_token&refresh_token=…&client_id=<app key>&client_secret=<app secret>, no Authorization header”, “FolderLongpoll (notify host): no Authorization header (Dropbox answers 400 ‘Your request includes an Authorization header, but this function does not use it.’)”]
• secrets: [“DROPBOX_ACCESS_TOKEN”, “DROPBOX_REFRESH_TOKEN”, “DROPBOX_APP_KEY”, “DROPBOX_APP_SECRET”]
• scopes: [“account_info.read”, “file_requests.read”, “file_requests.write”, “files.content.read”, “files.content.write”, “files.metadata.read”, “files.metadata.write”, “sharing.read”, “sharing.write”]
• note: Inject secrets with a LoT action (GET SECRET); never retain topics that carry the token, refresh token or app secret; restrict storage/dropbox/oauth/# with ACLs (the refresh response carries the new access token). Authorise once with token_access_type=offline to get a refresh token. App folder apps see only /Apps/<app>/.

​

Template parameters

​

Events

​

Deploy

mosquitto_pub -t '$SYS/Coreflux/Command' -m "-connectorCode DROPBOX_NOTIFY"

DEFINE CONNECTOR DropboxNotifyRestApi WITH TYPE REST_API
    ADD REST_API_CONFIG
        WITH BASE_ADDRESS "https://notify.dropboxapi.com"
        WITH ENABLE_CLIENT "true"
        WITH USE_SSL "true"
        WITH REQUEST_TIMEOUT '600'
        WITH DEFAULT_CONTENT_TYPE "application/json"
    ADD EVENT FolderLongpoll
        WITH SOURCE_TOPIC "storage/dropbox/folders/longpoll"
        WITH DESTINATION_TOPIC "storage/dropbox/folders/longpoll/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/2/files/list_folder/longpoll"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "User-Agent" "Coreflux-Broker REST_API route (https://www.coreflux.org)"
            ADD "Content-Type" "application/json"
        WITH BODY "{value.json.body}"

​

Usage example

mosquitto_sub -t 'storage/dropbox/folders/longpoll/response' &
mosquitto_pub -t 'storage/dropbox/folders/longpoll' -m '{"body": {}}'

​

Related

• REST API Connectors
• REST API Apps catalog