Twitter

The Posterous Twitter API lets you upload photos to a Posterous site. It is used with normal HTTP POST requests. Post data should be formatted as multipart/form-data. This API is a drop-in replacement for the Twitpic API.

The API uses Twitter credentials to upload media. If the Twitter user is registered on Posterous, it will post to their default Posterous site. If the user is not on Posterous, we will create a new site for them.

The media parameter can be an array of media. This includes images, audio, video, and common document formats.

URL

• http://posterous.com/api/upload
• http://posterous.com/api/uploadAndPost

Fields

• "username" - Required. Twitter username
• "password" - Required. Twitter password
• "media" - Optional. File data for single file.
• "media[]" - Optional. File data for multiple file upload. Can be specified multiple times.
• "message" - Optional. Title of post
• "body" - Optional. Body of post
• "source" - Optional. The name of your application or website
• "sourceLink" - Optional. Link to your application or website

"upload" will upload this image to Posterous. "uploadAndPost" will also tweet the message with a link.

  <?xml version="1.0" encoding="UTF-8"?>
  <rsp status="ok">
   <mediaid>url-slug-for-post</mediaid>
   <mediaurl>http://post.ly/abc123</mediaurl>
  </rsp>
	

    <?xml version="1.0" encoding="UTF-8"?>
    <rsp stat="fail">
        <err code="1001" msg="Invalid twitter username or password" />
    </rsp>
    

• 1001 - Invalid twitter username or password
• 1002 - Media not found
• 1003 - Invalid media
• 1004 - Media too large

• Max size of media is 100MB