API Documentation

Developer Key

In order to use Twiffo APIs you must first request a key by emailing to contact@twiffo.com. In your email, please include a description of how you intend to use Twiffo API.

METHOD - post

METHOD - get

Error Codes

METHOD: post

Use this method to post a message to Twiffo.

URL:

http://twiffo.com/api/post

HTTP Method:

POST

Response Format:

xml

Headers:

X-Auth-Service-Provider: https://api.twitter.com/1/account/verify_credentials.xml

X-Verify-Credentials-Authorization:

OAuth realm="http://api.twitter.com/",
oauth_consumer_key="",
oauth_signature_method="HMAC-SHA1",
oauth_token="",
oauth_timestamp="",
oauth_nonce="",
oauth_version="1.0",
oauth_signature=""

Parameters:

key (Required): Your API Key.

content (Required): Message content to post. (Max 14000 characters)

Sample Response:

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
  <user_id>86702763</user_id>
  <msg_code>6c</msg_code>
  <msg_link>http://twiffo.com/6c</msg_link>
  <short_text>Twiffo is a simple free service that allow you to post more than 
  140 characters to Twitter. Tell your friends about</short_text>
  <full_text>Twiffo is a simple free service that allow you to post more than 
  140 characters to Twitter. Tell your friends about us and start sharing more 
  on Twitter.</full_text>
  <post_text>Twiffo is a simple free service that allow you to post more than 
  140 characters to Twitter. Tell your friends about... 
  http://twiffo.com/6c</post_text>
</rsp>

METHOD: get

Return a message specified by the code parameter.

URL:

http://twiffo.com/api/get/code

HTTP Method:

GET

Response Format:

xml

Parameters:

code - The alphanumeric code for the message. The code is case-sensitve.

Sample Response:

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
  <user_id>86702763</user_id>
  <msg_code>6f</msg_code>
  <msg_link>http://twiffo.com/6f</msg_link>
</rsp>

Error Codes:

Below are the error codes and their description.

Codes:

1001 - Missing/Invalid parameters.

1002 - Invalid Twiffo API key.

1003 - Authorization failed.

1004 - Internal error.

1005 - Maximum of 2000 posts for this user within 24 hours reached.

1006 - Post content is empty.

1007 - Post content exceeded maximum limit of 14000 characters.

1008 - Message not found.

Sample Error Response:

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="fail">
  <err code="1001">Missing/Invalid parameters</err>
</rsp>