API Documentation
Any of the following API Methods can be hit with POST and GET. The return formats are either XML or JSON, as specified by the hit.
Submitting a paste...
URL
http://tinypaste.com/api/create.(xml|json)
ON SUCCESS
<?xml version="1.0" encoding="utf-8"?>
<result>
<response>xxxxx</response>
</result>
ON FAIL
<?xml version="1.0" encoding="utf-8"?>
<result>
<error>error_code_here</error>
</result>
ERROR CODES
paste_empty - paste supplied is empty
subdomain_short - subdomain supplied is shorter than 3 characters
subdomain_long - subdomain supplied is longer than 15 characters
subdomain_banned - subdomain is not allowed
is_code_error - is_code integer supplied is not 0 or 1
is_private_error - is_private integer supplied is not 0 or 1
expires_invalid - expires date is in the past, use GMT
auth_invalid - invalid authentification
parent_not_exist - parent paste id supplied does not exist
Required Parameters
paste
(string)
The text or code for the paste
Optional Parameters
title
(string)
- Letters and Numbers only. Will be shortened if longer than 40 characters.
a title for the paste
subdomain
(string)
- Letters and Numbers only. Between 3 and 15 characters maximum.
Paste will be shown on subdomain.tinypaste.com
is_code
(integer: 0 or 1)
1=paste will be parsed as code with highlighting and enabled compiler.
0=paste will be parsed as plain text. (recommended for non-code pastes)
is_private
(integer: 0 or 1)
1=paste will be hidden from Recent Pastes list.
0=paste will be shown on Recent Pastes List.
password
(string)
If set, viewers will be required to input a password to view the paste.
expires
(integer)
- Unix Timestamp in GMT
If set, the paste will be deleted at specified time.
authenticate
(string)
- conjoin username and password with a colon.
Stores the paste under the authenticated user.
Format: sampleuser:password
Password should be in MD5 format
parent
(string)
- must be valid paste #id
Sets as a revision of parent paste.