讨论组
BeTalk讨论组对象包括以下属性:
目录
- 讨论组对象属性:
- 讨论组文件页面数组对象的属性
- 讨论组成员(用户)数组对象属性:
- 讨论组标签数组对象的属性:
- 1. 获取讨论组列表
- 2. 创建讨论组
- 3. 获取讨论组详细信息
- 4. 更新讨论组
- 5. 删除讨论组
- 6. 邀请用户加入讨论组
- 7. 接受邀请加入讨论组
- 8. 添加团队用户到讨论组
- 9. 讨论组中更新用户
- 10. 从讨论组删除用户
- 11. 从讨论组删除自己
- 12. 下载讨论组文件页
- 13. 根据 BinderID复制讨论组
- 14. 获取讨论组链接
- 15. 获取讨论组对话
- 16. 在讨论组聊天发送消息
- 17. 讨论组中删除聊天消息
- 18. 添加一个任务项目
- 19. 更新任务项目
- 20. 删除任务项目
- 21. 讨论组任务项目清单
- 22. 待办事项附件上传
- 23. 删除待办事项附件
- 24. 封面上传
- 25. 删除讨论组封面
- 26. 打开讨论组通知
- 2.7 关闭讨论组通知
讨论组对象属性:
Name | 描述 | 例 |
ID | 讨论组ID | B7V4ze37oO08PYO70973lX6 |
name | 讨论组名称 | 我的第一个讨论组 |
status | 在该讨论组中用户属性 | BOARD_MEMBER,BOARD_INVITED |
created_time | 创建讨论组对象时的时间 | 1348864985783 |
updated_time | 讨论组对象更新的时间戳更新 | 1348864985783 |
feeds_timestamp | 时间戳,最后回复的时间戳,如果没有则为updated_time | 1348864985783 |
TOTAL_COMMENTS | 讨论组评论总数 | 10 |
total_members | 讨论组成员总数 | 4 |
TOTAL_PAGE | 讨论组文件数 | 20 |
total_todos | 讨论组待办事项的总数 | 18 |
revision | 讨论组的版本号 | 20 |
thumbnail_uri | 讨论组封面图片链接 | https://www.betalk.com/board/B7V4ze37oO08PYO70973lX6/6376 |
restricted | 讨论组是否只用于内部协作 | false |
conversation | 讨论组是否为聊天讨论组 | false |
team | 是否为团队讨论组 | false |
unread_feeds | 未读回复数量 | 2 |
last_feed | 最后讨论组回复 | |
binder_email | 讨论组电子邮件地址 | 1bb99dda0c52d475b8108b402c74bcc1@mail.nqsky.com |
讨论组文件页面数组对象的属性
Name | 描述 | 例 |
PAGE_ID | 文件 ID | 71 |
page_index | 原始页面顺序编号 | 10 |
original_file_name | 原文件名 | test.pdf |
Type | 页面类型:PAGE_TYPE_PDF,PAGE_TYPE_IMAGE,PAGE_TYPE_WHITEBOARD,PAGE_TYPE_AUDIO,PAGE_TYPE_VIDEO,PAGE_TYPE_NOTE,PAGE_TYPE_WEB,PAGE_TYPE_URL。 | PAGE_TYPE_PDF |
page_number | 页面展示顺序 | 45 |
page_uri | 页面链接 | https://www.betalk.com/board/B7V4ze37oO08PYO70973lX6/71 |
thumbnail_uri | 链接指向该页面的缩略图图像 | https://www.betalk.com/board/B7V4ze37oO08PYO70973lX6/71/74 |
background_uri | 链接指向页面背景图像 | https://www.betalk.com/board/B7V4ze37oO08PYO70973lX6/71/70 |
width | 页面宽度 | 1024 |
height | 页面的高度 | 768 |
revision | 页面的版本号 | 20 |
created_time | 创建页面对象时的时间戳 | 1348864985783 |
updated_time | 页面对象更新的时间戳 | 1348864985783 |
IS_DELETED | 标志页面是否被删除 | false |
讨论组成员(用户)数组对象属性:
Name | 描述 | 例 |
type | 用户在讨论组中属性 | BOARD_OWNER |
status | 用户在讨论组中状态 | BOARD_MEMBER,BOARD_INVITED |
created_time | 创建讨论组的时间戳 | 1348864985783 |
updated_time | 讨论组更新的时间戳 | 1348864985783 |
ID(在用户数组中) | 用户ID | UiaduESWsbzFoK9TOldC6zF |
name(在用户数组中) | 用户的全名 | 李四 |
email(用户数组中) | 用户的电子邮件地址,如果没有则为UNIQUE_ID | John.doe@acme.com |
UNIQUE_ID(在用户数组中) | 没有电子邮件地址的用户UNIQUE_ID | A453224 |
org_id(在用户数组中) | 企业组织ID,如果用户属于一个企业 | PZCuoBuYrnO4NXsdTmn4gP5 |
picture_uri(在用户数组中) | 用户头像链接 | https://www.betalk.com/board/ CBF2xn2Xa8sU1zXRkhpAZ0F4/user/2/5416 |
讨论组标签数组对象的属性:
Name | 描述 | 例 |
Name(在标签数组) | 标签名称 | Research |
Value(在标签数组) | 标签值 | Communicate |
1. 获取讨论组列表
通过{user_id}获取讨论组列表
GET /{user_id}/binders
URL参数
Name | 类型 | 描述 |
returnusers | Boolean | 可选:如果响应包含讨论组中用户列表。默认值为true。 |
filter | String | 可选:
|
sort | String | 可选:
|
timestamp | Number | 可选:自1/1/1970 0:0:0以毫秒为单位 |
count | Number | 可选:讨论组的最大数量返回数 |
category | String | 可选:特定的category_id; 例如,“301” |
unique_ids | String | 可选:讨论组用户列表,以“,”分隔unique_id; 例如,“12334,23212” |
emails | String | 可选:讨论组用户列表,以“,”分隔电子邮件地址; 例如,“joe@ yahoo.com,jim@ test.com” |
请求:
GET /me/binders
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"unread_feeds": 3,
"binders": [
{
"category": 2004,
"binder":
{
"id": "B9rArkzRe094lPPiMH4UpS8",
"name": "test",
"created_time": 1340839882787,
"updated_time": 1347925074233,
"total_comments": 0,
"total_members": 3,
"total_pages": 13,
"total_todos": 2,
"revision": 117,
"thumbnail_uri": "https://www.betalk.com/images/binder/default_cover.png",
"conversation": false,
"restricted": false,
"unread_feeds": 1,
"last_feed" : { "actor" : { "displayName" : "Test Wend",
"id" : "UiaduESWsbzFoK9TOldC6zF",
"image" : null,
"objectType" : "person",
"published" : "2014-11-11T03:15:18Z",
"updated" : "2015-03-12T01:34:59Z"
},
"generator" : { "id" : "B9rArkzRe094lPPiMH4UpS8" },
"object" : { "content" : "<p>a drawing</p>",
"id" : "369",
"objectType" : "comment",
"published" : "2015-01-10T08:53:08Z",
"updated" : "2015-01-10T08:53:08Z"
},
"published" : "2015-01-10T08:53:08Z",
"target" : { "displayName" : "Conversation",
"id" : "B9rArkzRe094lPPiMH4UpS8",
"image" : "https://www.betalk.com/board/B9rArkzRe094lPPiMH4UpS8/37",
"objectType" : "binder",
"published" : "2013-09-06T17:28:25Z",
"updated" : "2015-03-12T01:34:59Z",
"url" : "https://www.betalk.com/B9rArkzRe094lPPiMH4UpS8"
},
"verb" : "post"
},
"team": false,
"binder_email": "1bb99dda0c52d475b8108b402c74bcc1@mail.nqsky.com",
"users": [
{
"created_time": 1340839882787,
"revision": 36,
"status": "BOARD_MEMBER",
"type": "BOARD_OWNER",
"updated_time": 1343341334786,
"user": {
"email": "test@gmail.com",
"id": "UiaduESWsbzFoK9TOldC6zF",
"name": "Test Wend",
"picture_uri": "https://www.betalk.com/board/B9rArkzRe094lPPiMH4UpS8/user/3/2458"
}
},
{
"created_time": 1347693971840,
"revision": 106,
"status": "BOARD_INVITED",
"type": "BOARD_READ_WRITE",
"updated_time": 1347693971840,
"user": {
"email": "jrogers@btca.com"
}
},
{
"created_time": 1347920572382,
"revision": 108,
"status": "BOARD_INVITED",
"type": "BOARD_READ_WRITE",
"updated_time": 1347920572382,
"user": {
"email": "brenda@cardinal.net"
}
}
]
}
},
{
"category": 0,
"binder":
{
"id": "Bks9ZahBYl13Z9CKjB1srX5",
"name": "iPhone's Binder",
"created_time": 1341246771897,
"updated_time": 1343341325255,
"total_comments": 0,
"total_members": 1,
"total_pages": 1,
"total_todos": 0,
"revision": 248,
"thumbnail_uri": "https://www.betalk.com/images/binder/default_cover.png",
"conversation": false,
"restricted": false,
"unread_feeds": 0,
"last_feed": null,
"binder_email": "88skfddaseqwa0c52d475b810s8b402asc74b@BeTalk.me",
"team": false,
"users": [
{
"created_time": 1341246771897,
"revision": 5,
"status": "BOARD_MEMBER",
"type": "BOARD_OWNER",
"updated_time": 1343341325255,
"user": {
"email": "test@gmail.com",
"id": "UiaduESWsbzFoK9TOldC6zF",
"name": "Test Wend",
"picture_uri": "https://www.betalk.com/board/Bks9ZahBYl13Z9CKjB1srX5/user/1/224"
}
}
],
}
}
]
}
}
2. 创建讨论组
创建标识为{user_id}的讨论组。
POST / {USER_ID} /binders
JSON 参数
Name | 类型 | 例 |
name | String | 讨论组名称 |
restricted | Boolean | 可选:仅限于内部协作的讨论组。默认为false |
conversation | Boolean | 可选:讨论组是否为对话讨论组。默认为false |
suppress_feed | Boolean | 可选:是否关闭推送。默认为false |
Name(在标签数组; 可选:标签数组) | String | 标签名称 |
value(在标签数组; 可选:标签数组) | String | 标签值 |
请求:
POST /me/binders
{
"name": "Hello World"
}
带标签的请求:
POST /me/binders
{
"name": "Hello World",
"tags": [
{
"name": "Research",
"value": "Communicate"
}
]
}
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"id": "B7U3ze39oO08PYO70973lX6",
"name": "Hello World",
"revision": 3,
"created_time": 1342813061602,
"updated_time": 1342813061602
}
}
3. 获取讨论组详细信息
通过{binder_id}获取讨论组详细信息
GET/ {binder_id}
URL 参数
参数名 | 类型 | 描述 |
revision | Number | 可选:通过revision number获得讨论组详细信息 |
请求:
GET / B9rArkzRe094lPPiMH4UpS8
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"id": "B9rArkzRe094lPPiMH4UpS8",
"name": "test",
"created_time": 1340839882787,
"updated_time": 1347925074233,
"total_comments": 0,
"total_members": 3,
"total_pages": 2,
"total_todos": 6,
"revision": 133,
"thumbnail_uri": "https://www.betalk.com/images/binder/default_cover.png",
"conversation": false,
"restricted": false,
"unread_feeds": 0,
"binder_email": "1bb99dda0c52d475b8108b402c74bcc1@mail.nqsky.com",
"team": false,
"pages": [
{
"height": 768,
"page_index": 1,
"revision": 314,
"id": 71,
"page_uri": "/board/B9rArkzRe094lPPiMH4UpS8/71",
"thumbnail_uri": "/board/B9rArkzRe094lPPiMH4UpS8/71/73",
"width": 1024,
"is_deleted": false,
"created_time": 1347925037233,
"updated_time": 1347925037233
},
{
"height": 791,
"page_index": 2,
"revision": 578,
"id": 154,
"page_uri": "/board/B9rArkzRe094lPPiMH4UpS8/154",
"thumbnail_uri": "/board/B9rArkzRe094lPPiMH4UpS8/154/157",
"width": 612,
"is_deleted": false,
"created_time": 1347925064548,
"updated_time": 1347925064548
}
],
"users": [
{
"created_time": 1340839882787,
"revision": 36,
"status": "BOARD_MEMBER",
"type": "BOARD_OWNER",
"updated_time": 1343341334786,
"user": {
"email": "jon@gmail.com",
"id": "UiaduESWsbzFoK9TOldC6zF",
"name": "jonathan Chang"
}
},
{
"created_time": 1347693971840,
"revision": 106,
"status": "BOARD_INVITED",
"type": "BOARD_READ_WRITE",
"updated_time": 1347693971840,
"user": {
"email": "jrogers@btca.com"
}
},
{
"created_time": 1347920572382,
"revision": 108,
"status": "BOARD_INVITED",
"type": "BOARD_READ_WRITE",
"updated_time": 1347920572382,
"user": {
"email": "brenda@cardinal.net"
}
}
],
"tags": [
{
"name": "Research",
"value": "Communicate"
}
]
}
}
4. 更新讨论组
更新讨论组名称或标识{binder_id}标签。
POST/ {binder_id}
JSON参数
参数名 | 类型 | 描述 |
name | String | 讨论组的名称 |
name (在标签数组; 可选:标签数组) | String | 标签名称 |
value(在标签数组; 可选:标签数组) | String | 标签值。如果设定值是“”,该标签将被删除 |
请求:
POST /B7V4ze37oO08PYO70973lX6
{
"name": "API Discussion"
}
带标签的请求:
POST /B7V4ze37oO08PYO70973lX6
{
"tags": [
{
"name": "Research",
"value": ""
}
]
}
响应:
{
"code": "RESPONSE_SUCCESS"
}
5. 删除讨论组
根据{binder_id}删除讨论组。
DELETE/ {binder_id}
请求:
DELETE /B9rArkzRe094lPPiMH4UpS8
响应:
{
"code": "RESPONSE_SUCCESS"
}
6. 邀请用户加入讨论组
讨论组拥有者通过电子邮件或unique_id邀请用户加入{binder_id}的讨论组
POST/ {binder_id} / inviteuser
JSON 参数
参数名 | 类型 | 描述 |
email(用户数组) | String | 电子邮件地址邀请联系人 |
unique_id(用户数组) | String | unique_id邀请 |
org_id(用户数组) | String | 可选:org_id + unique_id邀请另一个组织用户 |
read_only(特定的用户数组) | Boolean | 可选:邀请的用户在该讨论组中权限为只读。默认为false |
message | String | 可选:电子邮件邀请中发送的消息 |
email_off | Boolean | 可选:是否关闭发送电子邮件。默认为false |
notification_off | Boolean | 可选:是否要关闭推送通知。默认为false |
suppress_feed | Boolean | 可选:是否关闭主动通知。默认为false |
请求:
POST /B7V4ze37oO08PYO70973lX6/inviteuser
{
"users": [
{
"user": {
"email": "test@gmail.com"
}
},
{
"read_only": true,
"user": {
"unique_id": "xa12233425343"
}
},
{
"user": {
"unique_id": "A453224",
"org_id": "PTHpzIJ4jGx1upvgjWZa4S1"
}
}
],
}
响应:
{
"code": "RESPONSE_SUCCESS"
}
7. 接受邀请加入讨论组
接受加入{binder_id}讨论组的邀请; 若拒绝使用邀请则从讨论组中删除。
POST/ {binder_id} / acceptinvite
JSON 参数
Name | 类型 | 描述 |
suppress_feed | Booolean | 可选:是否关闭订阅进行此操作。默认为false |
请求:
POST /B7V4ze37oO08PYO70973lX6/acceptinvite
响应:
{
"code": "RESPONSE_SUCCESS"
}
8. 添加团队用户到讨论组
添加同一个团队用户到讨论组。团队用户必须预先存在。
POST/ {binder_id} / addteamuser
JSON 参数
参数名 | 类型 | 描述 |
email(用户数组的用户) | String | 团队成员的电子邮件地址 |
unique_id((用户数组的用户) | String | 待添加的unique_id |
READ_ONLY((用户数组的特定用户) | Boolean | 可选:是否让团队用户只读讨论组。默认为false |
id(用户数组的用户) | string | 待添加的用户id |
suppress_feed | Boolean | 可选:是否关闭订阅此操作。默认为false |
请求:
POST /B7V4ze37oO08PYO70973lX6/addteamuser
{
"users": [
{
"user": {
"email": "test@xyz.com"
}
},
{
"read_only": true,
"user": {
"unique_id": "rf131zadad22312"
}
}
]
}
响应:
{
"code": "RESPONSE_SUCCESS"
}
9. 讨论组中更新用户
通过电子邮件地址或UNIQUE_ID变更用户在{binder_id}讨论组中的访问权限。
POST/ {binder_id} / updateUser
JSON 参数
参数名 | 类型 | 描述 |
email(用户数组的用户) | String | 在讨论组的用户的电子邮件地址 |
unique_id(用户数组的用户) | String | 在讨论组的用户unique_id |
org_id((用户数组的用户) | String | 可选:org_id + unique_id在讨论组中另一组织的用户 |
read_only(用户数组的特定用户) | Boolean | 可选:讨论组用户只有只读权限。默认值为false(读写权限) |
suppress_feed | Boolean | 可选:是否关闭订阅进行此操作。默认为false |
请求:
{
"users": [
{
"user": {
"email": "test@gmail.com"
}
},
{
"read_only": true,
"user": {
"unique_id": "xa12233425343"
}
},
{
"user": {
"unique_id": "A453224",
"org_id": "PTHpzIJ4jGx1upvgjWZa4S1"
}
}
],
}
响应:
{
"code": "RESPONSE_SUCCESS"
}
10. 从讨论组删除用户
通过{binder_id}删除讨论组用户。
POST/ {binder_id} / removeuser
JSON 参数
参数 | 类型 | 描述 |
String | 在讨论组中的现有用户的电子邮件地址 | |
unique_id | String | 讨论组中的现有用户unique_id |
org_id | String | 可选:org_id + unique_id删除讨论组内另一个组织用户 |
suppress_feed | Boolean | 可选:是否关闭订阅进行此操作。默认为false |
使用电子邮件地址的删除请求:
POST /B7V4ze37oO08PYO70973lX6/removeuser
{
"email": "joe@test.com"
}
使用UNIQUE_ID的删除请求:
POST /B7V4ze37oO08PYO70973lX6/removeuser
{
"unique_id": "fhas211nsjkaswd"
}
响应:
{
"code": "RESPONSE_SUCCESS"
}
11. 从讨论组删除自己
从讨论组中删除我,或拒绝邀请,将我从定{binder_id}讨论组删除。
POST/ {binder_id} / removeme
JSON 参数
参数名 | 类型 | 描述 |
suppress_feed | Boolean | 可选:是否关闭订阅进行此操作。默认为false |
请求:
POST /B7V4ze37oO08PYO70973lX6/removeme
响应:
{
"code": "RESPONSE_SUCCESS"
}
12. 下载讨论组文件页
下载{binder_id}讨论组的所有文件页面或者选择的页面。
GET/ {binder_id} / downloadpdf
URL 参数
参数名 | 类型 | 描述 |
filter | String | 可选:页面ID用 “,”分开 |
请求:
GET /B9rArkzRe094lPPiMH4UpS8/downloadpdf?filter=1,4
响应:
#PDF File
13. 根据 BinderID复制讨论组
复制{binder_id}的讨论组
POST/ {binder_id} /clone
JSON 参数
参数名 | 类型 | 描述 |
name | String | 新的讨论组的名字 |
请求:
POST /B7V4ze37oO08PYO70973lX6/clone
{
"name": "New Binder Name"
}
响应:
{
"code": "RESPONSE_SUCCESS"
"data": {
"binder_id": "Bks9ZahBYl13Z9CKjB1srX5",
"binder_name": "New Binder Name"
}
}
14. 获取讨论组链接
通过{binder_id}获取链接
GET/ {binder_id} / viewonlylink
URL参数
参数名 | 类型 | 描述 |
filter | String | 可选:页面ID用 “,”分开 |
请求:
GET /Bks9ZahBYl13Z9CKjB1srX5/viewonlylink
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"binder_id": "Bks9ZahBYl13Z9CKjB1srX5",
"binder_name": "iPhone's Binder",
"url": "https://www.betalk.com/v/CAEqBUxrZThOehdCdXp5BTFPa3dTMDg4RTZLdUFFY2ZHQ4ABFpADFA"
}
}
15. 获取讨论组对话
通过{binder_id}获取讨论组的谈话,格式遵循JSON规范。
GET/ {binder_id} /conversations
URL参数
参数名 | 类型 | 描述 |
timestamp | Number | 可选:以毫秒为单位在回复时间或更新的时间前从1/1/1970 0:0:0计数 |
count | Number | 可选:订阅的最大数量 |
请求:
GET /BRTaH8slmbPAY4odz0RbBIF/conversations
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"feeds" : [
{
"published": "2011-02-10T15:04:55Z",
"generator": {
"id": "BRTaH8slmbPAY4odz0RbBIF"
},
"actor": {
"objectType" : "person",
"id": "Utkj3YC5BxRHCCaq9widP67",
"image": "https://www.betalk.com/user/234",
"displayName": "Martin Smith"
},
"verb": "post",
"object" : {
"objectType": "comment",
"content": "hello",
"published": "2011-02-10T15:04:55Z",
"updated": "2011-02-10T15:04:55Z",
"id": "CAF829A6-F607-48E2-AA99-D081257CE78E"
},
"target" : {
"url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF",
"objectType": "binder",
"id": "BRTaH8slmbPAY4odz0RbBIF",
"displayName": "Martin binder",
}
},
{
"published": "2011-02-10T15:04:55Z",
"generator": {
"id": "BRTaH8slmbPAY4odz0RbBIF"
},
"actor": {
"objectType" : "person",
"id": "Utkj3YC5BxRHCCaq9widP67",
"image": "http://www.betalk.com/user/234",
"displayName": "Martin Smith"
},
"verb": "post",
"object" : {
"objectType": "comment",
"content": "testing page",
"published": "2011-02-10T15:04:55Z",
"updated": "2011-02-10T15:04:55Z",
"id": "CAF829A6-F607-48E2-AA99-D081257CE78E"
},
"target" : {
"url": "https://www.betalk.com/BRTaH8slmbPAY4odz0RbBIF/25",
"objectType": "page",
"id": "25",
"type": "PAGE_TYPE_IMAGE"
}
}
]
}
}
16. 在讨论组聊天发送消息
通过{binder_id}添加一条消息到讨论组聊天。
POST/ {binder_id} /comments
JSON 参数
参数名 | 类型 | 描述 |
text | String | 讨论组聊天消息 |
rich_text | String | 可选:提供BBCode格式 |
请求:
POST /B7V4ze37oO08PYO70973lX6/comments
{
"text": "This is a test message"
}
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"comment_id": 9
}
}
17. 讨论组中删除聊天消息
根据{binder_id}&{comment_id}删除聊天消息。
DELETE /{binder_id}/comments/{comment_id}
请求:
DELETE /B7V4ze37oO08PYO70973lX6/comments/24
响应:
{
"code": "RESPONSE_SUCCESS"
}
18. 添加一个任务项目
通过{binder_id}添加任务项目到讨论组。
POST/ {binder_id} /todos
JSON参数
参数名 | 类型 | 描述 |
name | String | 任务名 |
creator_id | String | 可选:创造此待办事项的用户ID |
due_time | Number | 可选:截至日期1/1/1970 0:0:0 |
assignee_id | String | 可选:分配的用户ID |
reminder_time | Number | 可选:提醒时间1/1/1970 0:0:0 |
comments | String | 可选:评论 |
description | String | 可选:描述 |
请求:
POST /B9rArkzRe094lPPiMH4UpS8/todos
{
"name": "Project X",
"creator_id": "Utkj3YC5BxRHCCaq9widP67",
"due_time": 1398495600000,
"assignee_id": "Ua9hIj1Bi33F3bxq5yQ4gCH",
"reminder_time": 1398296662605,
"comments": "Need to add budgets"
}
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
todos: [
{
"id": 266,
"name": "Project X",
"creator_id": "Utkj3YC5BxRHCCaq9widP67",
"due_time": 1398495600000,
"assignee_id": "Ua9hIj1Bi33F3bxq5yQ4gCH",
"reminder_time": 1398296662605,
"comments": "Need to add budgets",
"created_time": 1398292224675,
"updated_time": 1398292224675
}
]
}
}
19. 更新任务项目
根据{binder_id}&{todo_id}更新待办事项项目。
POST/ {binder_id} /todos/ {todo_id}
JSON 参数
参数名 | 类型 | 描述 |
name | String | 任务名 |
creator_id | Number | 创造此待办事项的用户ID |
due_time | Number | 截至日期1/1/1970 0:0:0 |
assignee_id | String | 分配的用户ID |
reminder_time | Number | 提醒时间1/1/1970 0:0:0 |
comments | String | 评论 |
description | String | 描述 |
fieldsToNull | String | 用逗号分割删除字段; 如:assignee_id,due_time,reminder_time |
请求:
POST /B9rArkzRe094lPPiMH4UpS8/todos/266
{
"assignee_id": "Utkj3YC5BxRHCCaq9widP67",
"fieldsToNull": "due_time,reminder_time"
}
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
todos: [
{
"id": 266,
"name": "Project X",
"creator_id": "Utkj3YC5BxRHCCaq9widP67",
"due_time": 0,
"assignee_id": "Utkj3YC5BxRHCCaq9widP67",
"reminder_time": 0,
"comments": "Need to add budgets",
"created_time": 1398292224675,
"updated_time": 1398296977505
}
]
}
}
20. 删除任务项目
根据{binder_id}&{todo_id}删除待办事项项目。
DELETE/ {binder_id} /todos/ {todo_id}
请求:
DELETE /B9rArkzRe094lPPiMH4UpS8/todos/266
响应:
{
"code": "RESPONSE_SUCCESS"
}
21. 讨论组任务项目清单
根据{binder_id}获取讨论组的所有待办事项如:
GET/ {binder_id} /todos
请求:
GET /Bks9ZahBYl13Z9CKjB1srX5/todos
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
todos: [
{
"id": 266,
"name": "Project X",
"creator_id": "Utkj3YC5BxRHCCaq9widP67",
"due_time": 1398495600000,
"assignee_id": "Ua9hIj1Bi33F3bxq5yQ4gCH",
"reminder_time": 1398296662605,
"comments": "Need to add budgets",
"created_time": 1398292224675,
"updated_time": 1398292224675
}
]
}
}
22. 待办事项附件上传
通过{todo_id}和{binder_id}上传待办事项附件
POST/ {binder_id} /todos/ {todo_id} /attachments
数据参数:
参数名 | 类型 | 描述 |
File | file | 上传到待办事项的实际文件 |
请求:
POST /B9rArkzRe094lPPiMH4UpS8/todos/266/attachments
...
Content-Type: multipart/form-data; boundary=---------------------------9051914041544843365972754266
Content-Length: 554
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpg
Content of image.jpg
响应:
{
"code": "RESPONSE_SUCCESS",
"data": {
"todo_id": "266",
"attachment_id": "47",
"created_time": 1398292224675,
"updated_time": 1398292224675
}
}
23. 删除待办事项附件
根据{attachment_id},{todo_id},和{binder_id}删除待办事项附件。
DELETE/ {binder_id} /todos/ {todo_id} /attachment/ {attachment_id}
请求:
DELETE /B9rArkzRe094lPPiMH4UpS8/todos/266/attachments/47
响应:
{
"code": "RESPONSE_SUCCESS"
}
24. 封面上传
通过{binder_id}上传讨论组封面图片。
POST/ {binder_id} / coverupload
表格数据参数
参数名 | 类型 | 描述 |
File | file | 上传到讨论组的实际图像文件 |
请求:
POST /B9rArkzRe094lPPiMH4UpS8/coverupload
...
Content-Type: multipart/form-data; boundary=---------------------------9051914041544843365972754266
Content-Length: 554
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpg
Content of image.jpg
响应:
{
"code": "RESPONSE_SUCCESS"
}
25. 删除讨论组封面
根据{binder_id}删除上传的封面。
DELETE/ {binder_id} /cover
请求:
DELETE /B9rArkzRe094lPPiMH4UpS8/cover
响应:
{
"code": "RESPONSE_SUCCESS"
}
26. 打开讨论组通知
根据{binder_id}打开讨论组通知。
POST/ {binder_id} /Notifications
请求:
POST /B7V4ze37oO08PYO70973lX6/notifications
响应:
{
"code": "RESPONSE_SUCCESS"
}
2.7 关闭讨论组通知
根据{binder_id}关闭讨论组通知。
DELETE/ {binder_id} /Notifications
请求:
DELETE /B9rArkzRe094lPPiMH4UpS8/notifications
响应:
{
"code": "RESPONSE_SUCCESS"
}