为webex团队api开发的社区python sdk
webexteamssdk的Python项目详细描述
使用原生python中的webex团队api!
正在查找``ciscosparkapi``?你在正确的地方。ciscosparkapi现在是webexteamssdk!它仍然拥有您喜爱的所有原生和自然webex团队python功能,现在我们已经为将来添加更多功能留出了空间。
我们将在这个存储库的ciscosparkapi分支中维护ciscosparkapipackage(错误修复等),并继续用这些修复将包更新发布到pypi(到2019年;nd)。维护ciscosparkapi包可以使代码和项目保持正常运行,同时给您12个月以上的时间将代码迁移到新的webexteamssdk库。
迁移注意:迁移应该很容易。api调用返回的WebexTeamsAPI类和python对象与它们的CiscoSparkAPI前置对象几乎相同。“差点”这个词吓到你了吗?以下是一些细节:
- 显而易见的顶级名称从CiscoSparkAPI更改为WebexTeamsAPI。
- WebexTeamsAPI的api结构:方法名和属性名是相同的。
- 返回的python对象(现在是不可变数据基类的派生对象)现在是不可变的;因此可以在集合中使用它们,也可以在字典中用作键。
- WebexTeamsAPI将包含数据时间字符串(如文件室的创建日期)的对象属性转换为pythondatetime(实际上是一个派生类,已自定义为webex团队数据时间格式建模)
还有一些新的功能,我们将记录,沟通,并通常在未来提供。
webexteamssdk是一个community开发的python库,用于使用webex团队api。我们的目标是让在python中与webex团队合作成为一种native和natural体验!
fromwebexteamssdkimportWebexTeamsAPIapi=WebexTeamsAPI()# Find all rooms that have 'webexteamssdk Demo' in their titleall_rooms=api.rooms.list()demo_rooms=[roomforroominall_roomsif'webexteamssdk Demo'inroom.title]# Delete all of the demo roomsforroomindemo_rooms:api.rooms.delete(room.id)# Create a new demo roomdemo_room=api.rooms.create('webexteamssdk Demo')# Add people to the new demo roomemail_addresses=["test01@cmlccie.com","test02@cmlccie.com"]foremailinemail_addresses:api.memberships.create(demo_room.id,personEmail=email)# Post a message to the new room, and upload a fileapi.messages.create(demo_room.id,text="Welcome to the room!",files=["https://www.webex.com/content/dam/wbx/us/images/dg-integ/teams_icon.png"])
这是超过6个WebEx团队API调用不到23行代码(带有注释和空白),而且很可能比这还要多,因为WebExteamSSDK会自动为您处理pagination!
webexteamssdk让你的生活更美好…Learn how!
功能
webexteamssdk为您完成所有这些:
- 从本地环境中透明地获取WebEx团队访问令牌
- 尽可能在任何地方提供并使用默认参数和设置,因此您不必考虑诸如api端点url、http头和json格式之类的内容
- 表示使用本机python工具的所有webex团队api交互
- 身份验证和到webex teams cloud的连接==>;webexteamsapi“连接对象”
- api调用==>;在webexteamsapi下按层次结构组织的方法“连接对象”
- 返回的数据对象==>;本机python对象
- 自动透明分页!
- 自动速率限制处理!(等待重试)
- 本地文件的多部分编码和上载
- 在您喜爱的IDE中自动完成、描述性异常等…
安装
安装和升级webexteamssdk很容易:
通过pip安装
升级到最新版本$ pip install webexteamssdk
$ pip install webexteamssdk --upgrade
发行说明
请参阅releases页以获取in上的发行说明已发布版本中包含的cremental功能和错误修复。
问题、支持和讨论
webexteamssdk是一个社区开发的和社区支持的项目。如果使用此软件包时遇到任何问题,请使用issues页面报告。
请加入Python Webex Teams Devswebex团队空间,提出问题,参与讨论,并分享您的项目和创作。