Twipic API :: Twipic

Twipic provide RESTfull api for upload and manage pictures.

Documentation

check.login
Description: Check authentication status on Twipic.
Url: http://twipic.me/api/check.login/
Parameters: -
Result: If client have valid http session result will be:
```
{
    "id_user":15763418,
    "screen_name":"grigorkin",
    "pictures_count":64
}
```
if not:
```
{
    "id_user":-1,
    "screen_name":null,
    "pictures_count":0
}
```
login
Description: Show the login page on the Twipic with Twitter.
Url: http://twipic.me/api/login/
Parameters: -
Result: If authentication is successful, then the client will redirect to http://twipic.me/api/login/ again.
upload
Description: Upload picture to Twipic.
Url: http://twipic.me/api/upload/
Method: POST
Parameters:
- pic_data - binary data of picture encoded by BASE64-method.
- name - picture name.
- post_to_twitter - send picture name and link to Twitter. Values: 1 or 0.
Result:
```
{
    "id_picture":419,
    "short_url":"http://twipic.me/QxKfA",
}
```

Description: Get uploaded pictures.
Url: http://twipic.me/api/get.pictures/
Parameters:

page - requested page
count - count pictures per page.

Result:

{
    "have_more":1,
    "pictures":[
    	{"id_picture":419,
    	 "view_count":140,
    	 "comments_count":0,
    	 "short_url":"http://twipic.me/QxKfA",
    	 "preview_url": "http://twipic.s3.amazonaws.com/15763418/0_8e8fefc6eb.gif",
    	 "medium_url": "http://twipic.s3.amazonaws.com/15763418/2_8e8fefc6eb.gif",
    	 "full_url": "http://twipic.s3.amazonaws.com/15763418/3_8e8fefc6eb.gif"
    	},
    	{"id_picture":420,
    	 "view_count":100,
    	 "comments_count":0,
    	 "short_url":"http://twipic.me/HYUnhf",
    	 "preview_url": "http://twipic.s3.amazonaws.com/15763418/0_a828a7bdf8.jpg",
    	 "medium_url": "http://twipic.s3.amazonaws.com/15763418/2_a828a7bdf8.jpg",
    	 "full_url": "http://twipic.s3.amazonaws.com/15763418/3_a828a7bdf8.jpg"
    	 }
    ]
}

delete.picture
Description: Delete uploaded picture.
Url: http://twipic.me/api/delete.picture/
Parameters:
- id_picture - id of picture
Result:
```
{
	"deleted_id_picture":420
}
```

get.comments

Description: Get comments.
Url: http://twipic.me/api/get.comments/
Parameters:

id_picture - id of picture

Result:

[
	{"id_comment":79,
	"id_user":"23427444",
	"id_picture":405
	"date_add":"on Jun 1, 2010 23:35"
	"text":"Mmm looks tasty! :)",
	"screen_name":"xxsabina",
	"profile_image_url":
        "http://a1.twimg.com/profile_images/902695322/Picture0002kopia_normal.jpg",
	},
	{"id_comment":78,
	"id_user":15763418,
	"id_picture":405
	"date_add":"on Jun 1, 2010 15:54"
	"text":"Happy birthday! :)",
	"screen_name":"grigorkin",
	"profile_image_url":
            "http://a3.twimg.com/profile_images/899903971/myava4_normal.png"
	}
]

Export picture feed to your blog

To export your picture feed to your blog, just add javascript-code with your Twitter ID to your blog:

<script type="text/javascript" src="http://twipic.me/extern/twipic.js?uid=YOUR_ID_USER"></script>

Example: