This API is deprecated, but shall continue to function for the forseeable future. DO NOT USE THIS FOR NEW INTEGRATIONS!

Authentication

Before you can use any of the API functions, you must pass the user's username and password to the API and request a token. This token can then be used to perform actions on the other SURL Network services.

POST /v1/auth

Parameters:
username - The username of the account (case-insensitive).
password - The password of the account (case-sensitive).
Returns:
token - The random token to be used for this account only, for presenting to service APIs.
username - The user's username.
email - The user's email address.

SmallImage

POST /v1/image/upload

Parameters:
apikey - The API token to be used during this query.
image - The file to be uploading (multipart).
title - The title of the image, shown publicly.
albumId - Optional id of the album to upload to.
Returns:
short - The randomly chosen ID for the image, used in the URL (http://surl.im/i/short).