文件接口

class teambition.api.works.Works(client=None)[源代码]
add_tag(id, tag_id)[源代码]

关联标签

参数:
  • id – 文件 ID
  • tag_id – 标签 ID
返回:

返回的 JSON 数据包

create(parent_id, file_name, file_size, file_type, file_category, file_key, image_width=None, image_height=None, involve_members=None)[源代码]

新建文件

详情请参考 http://docs.teambition.com/wiki/works#works-create

参数:
  • parent_id – 所属目录 ID
  • file_name – 文件名
  • file_size – 文件大小
  • file_type – 文件类型
  • file_category – 文件类别
  • file_key – 使用 striker 服务上传后可得
  • image_width – 可选,图片宽度
  • image_height – 可选,图片高度
  • involve_members – 可选
返回:

返回的 JSON 数据包

关联对象

参数:
  • id – 文件 ID
  • linked_id – 关联对象 ID
  • linked_type – 关联对象类型
返回:

返回的 JSON 数据包

create_version(id, file_name, file_size, file_type, file_category, file_key, image_width=None, image_height=None, involve_members=None)[源代码]

新建文件

详情请参考 http://docs.teambition.com/wiki/works-versions#works-versions-post

参数:
  • id – 文件 ID
  • file_name – 文件名
  • file_size – 文件大小
  • file_type – 文件类型
  • file_category – 文件类别
  • file_key – 使用 striker 服务上传后可得
  • image_width – 可选,图片宽度
  • image_height – 可选,图片高度
  • involve_members – 可选
返回:

返回的 JSON 数据包

delete(id)[源代码]

删除文件

详情请参考 http://docs.teambition.com/wiki/works#works-delete

参数:id – 文件 ID
返回:返回的 JSON 数据包
delete_version(id, version_id)[源代码]

删除单个历史版本

详情请参考 http://docs.teambition.com/wiki/works-versions#works-versions-delete

参数:
  • id – 文件 ID
  • version_id – 历史版本 ID
返回:

返回的 JSON 数据包

get(id=None, parent_id=None, page=None, count=None, all=None)[源代码]

获取文件信息

详情请参考 http://docs.teambition.com/wiki/works#works-get

参数:
  • id – 可选,文件 ID
  • parent_id – 可选,父级 ID
  • page – 可选,当前页,默认为 1
  • count – 可选,每页数量,默认为 30
  • all – 可选,若提供此参数则返回所有
返回:

返回的 JSON 数据包

get_activities(id)[源代码]

获取文件动态

参数:id – 文件 ID
返回:返回的 JSON 数据包

获取文件关联的 objectlink 列表

参数:id – 文件 ID
返回:返回的 JSON 数据包
get_tags(id)[源代码]

获取任务标签列表

参数:id – 文件 ID
返回:返回的 JSON 数据包
get_version(id, version_id)[源代码]

获取单个历史版本信息

详情请参考 http://docs.teambition.com/wiki/works-versions#works-versions-get

参数:
  • id – 文件 ID
  • version_id – 历史版本 ID
返回:

历史版本信息

get_versions(id)[源代码]

获取文件关联的历史版本信息

详情请参考 http://docs.teambition.com/wiki/works-versions#works-versions-list

参数:id – 文件 ID
返回:历史版本列表
like(id)[源代码]

赞文件

详情请参考 http://docs.teambition.com/wiki/works#works-like

参数:id – 文件 ID
返回:返回的 JSON 数据包

关联日程

参数:
  • id – 任务 ID
  • linked_id – 关联日程 ID
返回:

返回的 JSON 数据包

link_post(id, linked_id)[源代码]

关联分享

参数:
  • id – 任务 ID
  • linked_id – 关联分享 ID
返回:

返回的 JSON 数据包

关联任务

参数:
  • id – 任务 ID
  • linked_id – 关联任务 ID
返回:

返回的 JSON 数据包

关联文件

参数:
  • id – 任务 ID
  • linked_id – 关联文件 ID
返回:

返回的 JSON 数据包

move(id, parent_id)[源代码]

移动文件

详情请参考 http://docs.teambition.com/wiki/works#works-move

参数:
  • id – 文件 ID
  • parent_id – 新的目录 ID
返回:

返回的 JSON 数据包

remove_tag(id, tag_id)[源代码]

移除标签

参数:
  • id – 文件 ID
  • name – 标签 ID
返回:

返回的 JSON 数据包

update(id, file_name, description=None)[源代码]

更新文件

详情请参考 http://docs.teambition.com/wiki/works#works-update

参数:
  • id – 文件 ID
  • file_name – 文件名
  • description – 可选,描述
返回:

返回的 JSON 数据包

update_members(id, members)[源代码]

更新文件参与者

详情请参考 http://docs.teambition.com/wiki/works#works-update-involvemembers

参数:
  • id – 文件 ID
  • members – 参与者 ID 列表
返回:

返回的 JSON 数据包

update_version(id, version_id, file_name=None, description=None)[源代码]

获取单个历史版本信息

详情请参考 http://docs.teambition.com/wiki/works-versions#works-versions-update

参数:
  • id – 文件 ID
  • version_id – 历史版本 ID
  • file_name – 可选,文件名
  • description – 可选,描述
返回:

返回的 JSON 数据包