Custom Url Shortener

Dropshare supports a wide variation of custom URL shortener services. To set up a custom URL shortener, open the Preferences and select the Uploads tab.

Besides dsh.re (the free built-in shortener service), Dropshare supports setting up your own URL shortener solution.

When choosing Custom (advanced), various parameters can be set up to configure a custom URL shortener.

Preference	Description
Endpoint	URL to your custom URL shortener or its API. The URL could look like: http://shorten.er/api/shorten-url
URL Parameter	HTTP Method (e.g. POST, GET) and name of the parameter which contains the long unshortened URL
Additional Parameters	Additional parameters (Query if GET, Body if POST) for the request
Auth. Parameter	Authentication Parameter Type (GET, POST, Header), name of the parameter (e.g. Authentication), and value (e.g. API Key)
Response Format	Type of response (JSON or Plaintext). If JSON, nested parameters can be accessed with dot-notation (e.g. data.shortUrl)

When clicking Test, Dropshare will try to shorten a URL and see whether it parse the configured API response.

Debugging a custom URL shortener

In case Dropshare is unable to work with your custom URL shortener, please consult the logs. The app will verbosely log the response it got for its request, and most likely tell you why it couldn't parse the shortened URL out of it. Please submit a support request in case you need help debugging an error with custom URL shorteners. Please make sure to include all logs.

Compatible URL shorteners

Dropshare for Mac is compatible with several (open source) URL shorteners, including (but not limited to):

Preference	Description
dub.co	How to set up dub.co as URL shortener?
bit.ly	How to set up bit.ly as URL shortener?
Rebrandly	How to set up Rebrandly as URL shortener?
YOURLS.org	Endpoint URL, for username/password authentication, use: http://shorten.er/yourls-api.php?username=<username>&password=<password>&action=shorturl&format=json for signature token authentication, use: http://shorten.er/yourls-api.php?signature=<signature\_token>&action=shorturl&format=json Parameter name: url Method: GET
Shlink	How to set up Shlink as URL shortener?

If you'd like to have better support for a custom URL shortener, please drop us a line.