讨论组

BeTalk讨论组对象包括以下属性:

讨论组对象属性:

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"
}