讨论组

首页 > 文档 > 讨论组

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	可选： “name” – 返回讨论组，按讨论组名称升序排列。 “feeds” – 返回讨论组，按讨论组回复时间戳倒叙排列。默认值是按创建时间升序排列返回讨论组。
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 参数

参数	类型	描述
email	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"
}

BeTalk

iOS SDK

Android SDK

JavaScript SDK

BeTalk REST API

用户认证

讨论组

讨论组对象属性：

讨论组文件页面数组对象的属性

讨论组成员（用户）数组对象属性：

讨论组标签数组对象的属性：

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 关闭讨论组通知