jwplatform 1.2.2

安装

jw平台api库可以使用pip安装：

$ pip install jwplatform

库将Requests包作为依赖项。使用pip安装时将自动安装。

用法

导入jwplatform库：

>>>importjwplatform

初始化jwplatform客户机实例（API密钥和机密可以在jw平台仪表板的帐户选项卡下找到）：

>>>jwplatform_client=jwplatform.Client('API_KEY','API_SECRET')

提出一个api请求。对于本例，使用/videos/showapi资源：

>>>response=jwplatform_client.videos.show(video_key='yYul4DRz')

如果api请求成功，response变量将包含字典，其中包含与响应相关的信息和response['video']中的实际视频数据：

>>>response{'rate_limit':{'limit':50,'remaining':47,'reset':1469105100},'status':'ok','video':{'author':None,'custom':{'param1':'value 1','param2':'value 2'},'date':1225962900,'description':None,'duration':'12.0','error':None,'expires_date':1459908560,'key':'yYul4DRz','link':'http://www.jwplatform.com','md5':'b2d7312bd39cc60e9facc8ed3cbb6418','mediatype':'video','size':'29478520','sourceformat':None,'sourcetype':'file','sourceurl':None,'status':'ready','tags':'new, video','title':'New test video','upload_session_id':None,'views':123}}

如果response['status']设置为error，JW平台API库将引发从jwplatform.errors.JWPlatformError继承的异常。例如，没有/media/showapi资源。请求它将引发jwplatform.errors.JWPlatformNotFoundError：

>>>try:...jwplatform_client.media.show()...exceptjwplatform.errors.JWPlatformNotFoundErroraserr:...print(err.message)APImethod`/media/show`notfound

有关可用异常的完整列表，请参见jwplatform/errors.py文件。

除了引发jwplatform.errors.JWPlatformError异常之外，jw平台api库还将 从Requests包中重新引发requests.exceptions.RequestException异常。

源代码

在GitHub上提供的JW平台API库的源代码。

许可证

jw平台api库分布在MIT license下。

1.2.2（2018-04-10）

• 默认情况下，post请求的参数现在包含在请求正文中

1.2.1（2017-11-20）

• 改进了实例化客户机时的默认参数处理
• 增加了指数连接退避

1.2.0（2016-11-22）

• 在API请求中允许附加请求包参数

1.1.0（2016-11-03）

• 添加了JwPlatformRateLimitExcepederRor异常

1.0.0（2016-07-21）

• 初次发布。