Bookmarklets

YOURLS comes with two handy bookmarklets for easier link shortening.

• The simple one generates a short URL from the page you are currently viewing.
• The second one does the same but first asks for a custom URL keyword – if you enter none a random one will be picked.

The bookmarklets will take you to a page where you can easily edit or delete your brand new short URL.

There is also a Quick Share tool box to make posting to Twitter, Facebook or Friendfeed a snap.

If you want to share a description along with the link you're shortening, simply select text on the page you're viewing before clicking on your bookmarklet link

• Simple bookmarklet

  Click and drag the link to your toolbar: Shorten

• Advanced bookmarklet (custom keyword)

  Click and drag the link to your toolbar: Custom shorten

Secure passwordless API call

YOURLS allows API calls the old fashioned way, using username and password parameters. If you're worried about sending your credentials into the wild, you can also make API calls without using your login or your password, using a secret signature token.

Your secret signature token: (It's a secret. Keep it secret)

This signature token can only be used with the API, not with the admin interface.

• Usage of the signature token

  Simply use parameter signature in your API requests. Example:

  /yourls-api.php?signature=&action=...

• Usage of a time limited signature token

  <?php
  $timestamp = time();
  // actual value: $time = 
  $signature = md5( $timestamp . '' ); 
  // actual value: $signature = ""
  ?> 
  

  Now use parameters signature and timestamp in your API requests. Example:

  /yourls-api.php?timestamp=$timestamp&signature=$signature&action=...

  Actual values:
  /yourls-api.php?timestamp=&signature=&action=...

  This URL would be valid for only seconds

(See the API documentation for more)