Lessn More API
The Lessn More API is inherited from the original Lessn.
It's really simple. In fact, it's all just HTTP GET requests.
If you get a URL back, your request succeeded. If not, you're looking at an error message.
Authenticating
/-/?api=YOUR_API_KEY
Your API key is displayed when you log in to Lessn More.
Your API key must be used for every request.
Example usage: http://example.com/-/?url=http://google.com/&api=a8b45c20205f8bb34c
Get a short URL
Add a URL, or get the short URL for a URL already in the system - same call:
/-/?api=KEY&url=YOUR_URL
YOUR_URL must be escaped. In JavaScript, use encodeURIComponent().
Set a custom short URL
/-/?api=KEY&url=URL&custom_url=SLUG
Your slug should NOT start with a slash. Example slug: markdown
.
Though it is not recommended, setting the GET variable overwrite
will force the call to succeed, even
if the slug already redirects somewhere else!
Remove a redirection
/-/?api=KEY&mark_gone&slug=SLUG
The redirection for the slug named SLUG
will be marked as deleted. Requests for it will result in a 410 Gone error page.
(Not implemented yet, as of v. 2.0.; however the change could be made in the database.)
Redirect
redirect: allows you to create custom redirects. %l
in the value of redirect is replaced with the Lessn'd url. Mostly useful for bookmarklets or other mashups.
Example usage, http://yourdomain.com/-/?url=<long url>&redirect=http%3A%2F%2Ftwitter.com%2F%3Fstatus%3D%l