Dropshare User Guide

Search for answers to your questions by entering keywords below, or look through our knowledge base.

How to set up a custom URL shortener

Dropshare for Mac 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 and goo.gl, Dropshare for Mac supports setting up your very own URL shortener solution. You are required to set up two preferences to make a custom URL shortener work:

Preference Meaning
Custom endpoint URL URL to your custom URL shortener or its API. The URL could look like:
http://shorten.er/api/?username=example&key=Eefeil8T
Parameter name Name of the request parameter that Dropshare for Mac adds to the given endpoint URL. The value for this parameter will be the original URL to the uploaded file.

Dropshare for Mac understands a JSON or plaintext formatted response. If your API returns plaintext, the app expects the response to be only the shortened URL, e.g. http://shorten.er/aik9X. In case your API returns a JSON formatted string, the app expects the shortened URL in the key shorturl. An example JSON formatted response could be:

{
  "status": "success",
  "message": "http://getdropsha.re added to database",
  "shorturl": "http://shorten.er/aik9X",
  "statusCode": 200
}

Dropshare for Mac will ignore everything but the shorturl key.

Compatible (open source) URL shorteners

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

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

Debugging a custom URL shortener

In case Dropshare for Mac 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 produced by Dropshare for Mac.

Was this article helpful?
3 out of 6 found this helpful

Powered by Zendesk