“Xproject api设计”的版本间的差异

2012年12月8日 (六) 15:57的版本

规范

• 协议格式：使用json序列化
• 基础对象:
  • User
    • display_name
    • username
    • medias 音频数
    • followers 关注者数目
    • followings 关注中的用户数
    • profile_picture 照片
  • Media
    • path 下载路径
    • description 描述文字
    • checksum 校验和
    • owner 拥有者
    • created 创建时间

== Users ==

GETusers/{user-id} GETusers/self/feed GETusers/{user-id}/media/recent GETusers/self/media/liked GETusers/search Relationships GETusers/{user-id}/follows GETusers/{user-id}/followed-by GETusers/self/requested-by GETusers/{user-id}/relationship (GET) POSTusers/{user-id}/relationship (POST) Media GETmedia/{id} GETmedia/search GETmedia/popular Comments GETmedia/{media-id}/comments (GET) POSTmedia/{media-id}/comments (POST) DELETEmedia/{media-id}/comments/{comment-id} Likes GETmedia/{media-id}/likes (GET) POSTmedia/{media-id}/likes (POST) DELETEmedia/{media-id}/likes (DELETE) Tags GETtags/{tag-name} GETtags/{tag-name}/media/recent GETtags/search Locations GETlocations/{location-id} GETlocations/{location-id}/media/recent GETlocations/search Subscriptions POSTsubscriptions (POST) [User] POSTsubscriptions (POST) [Tag] POSTsubscriptions (POST) [Location] POSTsubscriptions (POST) [Geography] GETsubscriptions (GET) DELETEsubscriptions (DELETE) Authentication No AuthFeedback ◀ Request URL Send

▼ Query Template Headers

用户管理

• GET /users/{user-id} 获取用户信息，返回User
• GET /users/self/feed 获取自己的feed
• GET /users/{user-id}/media/recent 获取自己最近的media
• GET /users/self/media/liked 获取自己liked的media列表
• GET /users/search 查询用户

用户关系

GETusers/{user-id}/follows GETusers/{user-id}/followed-by GETusers/self/requested-by GETusers/{user-id}/relationship (GET) POSTusers/{user-id}/relationship (POST) Media GETmedia/{id} GETmedia/search GETmedia/popular Comments GETmedia/{media-id}/comments (GET) POSTmedia/{media-id}/comments (POST) DELETEmedia/{media-id}/comments/{comment-id} Likes GETmedia/{media-id}/likes (GET) POSTmedia/{media-id}/likes (POST) DELETEmedia/{media-id}/likes (DELETE) Tags GETtags/{tag-name} GETtags/{tag-name}/media/recent GETtags/search Locations GETlocations/{location-id} GETlocations/{location-id}/media/recent GETlocations/search Subscriptions POSTsubscriptions (POST) [User] POSTsubscriptions (POST) [Tag] POSTsubscriptions (POST) [Location] POSTsubscriptions (POST) [Geography] GETsubscriptions (GET) DELETEsubscriptions (DELETE)