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. |
| HTTP method | Select HTTP method to use for requesting the shortened URL |
| Content type | Select HTTP Content Type for the request |
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):
- dub.co
Learn how to set up dub.co here. - bit.ly
Learn how to set up bit.ly here. - Rebrandly
Learn how to set up Rebrandly here. - YOURLS.org
Endpoint URL: http://shorten.er/yourls-api.php?username=<username>&password=<password>&action=shorturl&format=json
Parameter name: url
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.
Last updated: