“Xproject api设计”的版本间的差异
Dennis zhuang(讨论 | 贡献) (以“== 规范 == * 协议格式:使用json序列化 * 基础对象: ** User *** display_name *** username *** medias 音频数 *** followers 关注者数目 *** foll...”为内容创建页面) |
Dennis zhuang(讨论 | 贡献) (→规范) |
||
第16行: | 第16行: | ||
*** owner 拥有者 | *** owner 拥有者 | ||
*** created 创建时间 | *** 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 | ||
== 用户管理 == | == 用户管理 == |
2012年12月8日 (六) 15:57的版本
规范
- 协议格式:使用json序列化
- 基础对象:
- User
- display_name
- username
- medias 音频数
- followers 关注者数目
- followings 关注中的用户数
- profile_picture 照片
- Media
- path 下载路径
- description 描述文字
- checksum 校验和
- owner 拥有者
- created 创建时间
- User
== 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)