api information

We have a simple API that can be used to "sceneify" URLs. For example, you may choose to create them from a custom application, or your bookmark toolbar plugin.

In order to minimise the impact of spambots and misuse, you will require an API key. The key is simply added to whatever creation requests you send to the API. The API key and access to the API is and will stay completely cost-free.

Please get in touch via our contact page to request a key!

Ok, let's get down to business; to "sceneify" an URL, you create either a POST or a GET-request to http://scenes.at/c, for example here is a GET-method:

http://scenes.at/c?link=[url]&alias=[alias]&pwd=[password]&api=[anything]&key=[api-key]

The parameters are as follows (* = mandatory):
ParameterExplanation
link* A full URL (including http:// etc.) to "sceneify".
alias The alias you want to give the link. If left out or already taken, a new will be generated for you. Up to 128 characters, consisting of a-z, 0-9 and -.
pwd Require the visitor to enter this (optional) password. After entering the password, the visitor is taken to the destination URL.
api Tells the system to return only a simple text-based reply for easier parsing. Instead of rendering a full HTML page, it will return a "sceneified" URL with either a successful "sceneified" link, or one of the following messages: "Error", "Declined", "Invalid URL" or "Not allowed destination". This API option can be set to any or no value (any parameter passed to it is a dummy).
key Your personalized API key. Must be used to "sceneify" a link from an application that does not generate an HTTP_REFERER.

To add a little tool to help "sceneify" URLs straight from your browser, drag one of the links below and place it as a bookmark somewhere on the browser toolbar. To make it work, you will need to edit the bookmark and exchange [apikey] with your personal API key. Use the second link to get a prompt for a custom alias.

sceneify »

sceneify (with alias) »