Skip to content

Piictu REST API

rafael edited this page Feb 25, 2012 · 4 revisions

REST Resources.

The Piictu API includes the following RESTful methods.

User Resources

Resource Description
GET v2/users/:user_id Get user info
GET v2/current_user Get current user
PUT v2/current_user Update current user
GET v2/users/:user_id/photos Get recent photos
GET v2/users/:user_id/streams Get recent streams
GET v2/timeline Get timeline
GET v2/users/:user_id/friends Get friends
GET v2/users/:user_id/followers Get followers
GET v2/users/:user_id/friends/ids Get friends ids
POST v2/current_user/reset_badge Reset APN Badge count
GET v2/users/search Search users
POST v2/current_user/logout Logout User

Stream Resources

Resource Description
GET v2/streams/new Create Stream
GET v2/streams/edit Reply to a Stream
GET v2/streams/:stream_id Get stream info **(adjusted)**
GET v2/streams/:stream_id/friends Get involved friends
GET v2/streams/:stream_id/users/:user_id Get photos from a user in one stream
GET v2/streams Recently updated list
GET v1/streams/popular Popular streams list
GET v2/streams/:stream_id/trackers Get trackers
POST v2/streams/:stream_id/share Share stream
GET v2/streams/search Search streams
GET v1/streams/by_ids Get streams by ids

Photo Resources

Resource Description
GET v2/photos/:photo_id Get photo info
DELETE v2/photos/:photo_id Delete photo
POST v2/photos/:photo_id/like Like a photo
POST v2/photos/:photo_id/delete_like Delete Like on a photo (unlike)
GET v2/photos/:photo_id/users_like Users who likes a photo
POST v2/photos/:photo_id/flag Flag a photo
POST v2/photos/:photo_id/unflag Unflag a photo
POST v2/photos/:photo_id/share Share photo
GET v2/photos/search Search photos
GET v2/photos/:stream_id/mentions Get mentioned friends

Friendship methods

Resource Description
POST v2/friendships Add a friend to current user
DELETE v2/friendships/:user_id Unfollow a friend
POST v2/friendships/follow_group Add a group of friends to current user.

Trackings methods

Resource Description
POST v2/trackings Track stream
DELETE v2/trackings/:stream_id Untrack stream
GET v2/trackings Get tracked streams

Notifications methods

Resource Description
GET v2/notifications Recent notifications list
GET v2/notifications/news_count Unseen notifications count

Suggestions

Resource Description
GET v2/suggestions Users-and-streams-suggestions

Blocking functionalities.

Resource Description
GET v2/blocks Get blocked users
POST v2/blocks Block a user|
DELETE v2/blocks/:user_id Unblock a user

Clone this wiki locally