rnm.me // Rename a too long url

Short URLs are created using the rename!me-API "http://rnm.me/api.php". The methods "GET" and "POST" can be used.

For this purpose, at least the parameters "url" and "apikey" will be required, "pw", "app" and "myurl" are optional.

Example contain all parameters:

http://rnm.me/api.php?url=http%3A%2F%2Fmaps.google.de%2Fmaps %3Ff%3Dq%26source%3Ds_q%26hl%3Dde%26geocode%3D%26q%3D Venedig%26sll%3D51.151786%2C10.415039%26sspn%3D20.5859 61%2C44.121094%26ie%3DUTF8%26ll%3D45.434358%2C12.33876 2%26spn%3D0.044871%2C0.086174%26t%3Dh%26z%3D14& pw=mynewpassword&app=My-App& myurl=mynewurl&apikey=myapikey

This call would spend if successful, the following URL in the content of the response:

http://rnm.me/mynewurl-mynewpassword

Example, only the parameter 'url':

http://rnm.me/api.php?url=http%3A%2F%2Fmaps.google.de%2Fmaps
%3Ff%3Dq%26source%3Ds_q%26hl%3Dde%26geocode%3D%26q%3DVenedig
%26sll%3D51.151786%2C10.415039%26sspn%3D20.585961%2C44.12109
4%26ie%3DUTF8%26ll%3D45.434358%2C12.338762%26spn%3D0.044871%
2C0.086174%26t%3Dh%26z%3D14&apikey=myapikey

This call would spend if successful, the following URL in the content of the response:

http://rnm.me/ppn0ue

url	To be shortened, the web address (URL), it must exist and encoded.
apikey	Needed parameter, saves your urls to your Facebook or Twitter Account.
pw (optional)	Password, without a referral to the source URL is not possible. Allowed characters: a-z, A-Z, 0-9. The signs "-", "_", "." and ";" are not allowed.
title (optional)	Site title, describes how the page is called. Appears in the 'your last 10-urls' Baloon as page name.
app (optional)	For the purpose of statistics, the program can be named to be used with the short URL. (Maximum number of characters: 15)
myurl (optional)	An optional rename!me request URL. If this parameter is not present, the URL is randomly generated. Allowed characters: a-z, A-Z, 0-9. The signs "-", "_", "." and ";" are not allowed.

Code 200

The URL was successfully reduced.

http://rnm.me/1

http://rnm.me/mynewurl-mynewpassword

Code 400

There was an error, this returns the following occur:

Parameter 'url' is missing:

url not filled

'url' has the wrong format

url incorrect

'url' is too short, the complete URL must possess more than eight characters:

url is too short, count of chars must be more than 8

The URL of rename!me can not be reduced:

url callback

Code 401

There was an error, this returns the following occur:

Parameter 'apikey' is missing:

wrong user

Use the rename!me Preview API "http://rnm.me/preview.php" to see which URLs are behind the rename!me-URLs. The methods "GET" and "POST" can be used.

For this purpose, one of the parameters "short" or "url" will be required. The different editions "url", "title" and "clicks are with '\r\n' separately.

Just take a look a our PHPRNLib (PHP rename Libary) for more options to preview any kind of short links! It also include image seperations of twitpic.com, yfrog, img.ly, skitch.com and flic.kr

Example with the parameter 'short':

http://rnm.me/preview.php?short=2

Example with the parameter 'url':

http://rnm.me/preview.php?url=http://rnm.me/2

These calls would display the following string on success in the content of the answer:

http://google.de/
Google
15

The first line describes the URL will be passed on, the second line contains the title, the third the clicks, so as if the link has already been clicked.

Code 200

The preview control problems, the separation of information is done with '\r\n'.

http://google.de/
Google
15

Code 400

There was an error occurs while the following return:

Abbreviated Shortcut was not found:

short not found

Images of strings are created with the rename!me-Sting2Image API "http://str.rnm.me/api.php". The methods "GET" and "POST" can be used.

For this purpose, at least the parameter "str" will be required, "pw", "app" and "myurl" are optional.

For example with all parameters:

http://str.rnm.me/api.php?str=mein%20String&pw=mynewpassword&app=My-Client&myurl=mynewurl

Dieser Aufruf würde bei Erfolg folgende URL im Inhalt der Antwort ausgeben:

http://str.rnm.me/mynewurl-mynewpassword

An example, only with the parameter 'str':

http://str.rnm.me/api.php?str=ichtestegerne@rnm.me

This call would spend, if successful, the following URL in the content of the response:

http://str.rnm.me/5

str	The desired string to be displayed as an image. This parameter must be present and encoded.
pw (optional)	Password, without a referral to the source URL is not possible. Allowed characters: a-z, A-Z, 0-9. The signs "-", "_", "." and ";" are not allowed.
app (optional)	For the purpose of statistics, the program can be named with the String2Image-URL is be used. (Maximum number of characters: 15)
myurl (optional)	An optional rename!me String2Image-request-URL. If this parameter is not present, the rename!me-API will create a randomly generated URL. Allowed characters: a-z, A-Z, 0-9. The signs "-", "_", "." and ";" are not allowed.

Code 200

The string has been successfully entered into the database and is now available.

http://str.rnm.me/5

http://str.rnm.me/meineneueurl-meinpasswort

Code 400

There was an error occurs while the following return:

Parameter 'url' is missing:

str not filled