FlicIn

API Documentation

To get your API key click here

1. METHOD: http://flicin.com/photos/upload_and_post.xml

   Use this method to upload an image to FlicIn and to send it as a status update to Twitter.

   Fields to post in (post data should be formatted as multipart/form-data)

   - media (required) - Binary image data

   - username (required) - Twitter username

   - password (required) - Twitter password

   - application key (optional)

   - message (optional) - Message to post to twitter. The URL of the image is automatically added.

   Sample response:

   	 <?xml version="1.0" encoding="UTF-8"?>
   	 <rsp status="ok">
   	 <statusid>1111</statusid>
   	 <userid>11111</userid>
   	 <mediaid>f2a</mediaid>
   	 <mediaurl>http://flicin.com/f2a</mediaurl>
   	</rsp>
   					

   For quick sandbox testing: http://flicin.com/sandbox/upload_and_post

2. METHOD: http://flicin.com/photos/upload.xml

   Use this method if you only want to upload a photo to FlicIn

   Fields to post in (post data should be formatted as multipart/form-data)

   - media (required) - Binary image data

   - username (required) - Twitter username

   - password (required) - Twitter password

   - application key (optional)

   Sample response:

   	 <?xml version="1.0" encoding="UTF-8"?>
   	 <rsp status="ok">
   	 <mediaid>f2a</mediaid>
   	 <mediaurl>http://flicin.com/f2a</mediaurl>
   	</rsp>
   					

   For quick sandbox testing: http://flicin.com/sandbox/upload

   Sample error response:

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

3. Error codes and their descriptions:

   1001 - Invalid twitter username or password

   1002 - Image not found

   1003 - Application key not valid

4. Image thumbnails:

   Use the following URL structure to add FlicIn thumbnails into your app:

   http://flicin.com/ <type><image-id>
   

   Type:

   e2 or fe2

   Example:

   http://flicin.com/e2a

   *note:

   FlicIn Community Guidelines specify that if you use a FlicIn thumbnail in your app, the photo must link back to its original photo page or a link to the original photo page must be provided somewhere within context to the thumbnail

5. How do I get "from [my_application]" appended to updates sent from my API application?

   You need to fill the API form with the necessary details, after you submitting that form we will send a unique application key to your mail. Using that key you can upload through your applications. To get your API key click here