DailyMotion云API客户端库
cloudke的Python项目详细描述
简介
_ python sdk:http://www.dmcloud.net/doc/api/python sdk.html
。_ Cloud-API:http://www.dmcloud.net/doc/api/
。_ media-api:http://www.dmcloud.net/doc/api/cloud-api.html；媒体api
。_媒体对象：http://www.dmcloud.net/doc/api/cloud api.html；媒体api
…_文件对象：http://www.dmcloud.net/doc/api/cloud-api.html；file-api
************************************
br/>>一般信息
=================
>python库公开了《云api》一节中描述的所有api方法，这些api方法都是在《云api》一节中描述的。br/>你可以下载python库到http://github.com/dailymotion/cloudkey py>；` ` ` `.
用于特定目的的方法，如上载文件或获取签名的流URL。例如，要从"media"对象调用"list"方法，
代码如下：
api_key）
cloudkey.media.list（）
对于需要参数的方法，这些参数必须作为命名参数传递：
cloudkey.media.list（fields=['id']，per_page=20，page=2）
路径。
：param file：文件的路径
：type file:str
：返回一个dict，其中包含可以访问上载文件的"url"
：rtype:dict
对象`
^^^^^^^^^^^^^^^^^^^^
``获取嵌入URL（id，seclevel=none，asnum=none，ip=none，useragent=none，expires=none，secure=false）```
并基于
提供的安全级别位掩码授予访问权。
：param id：新媒体对象的ID。
：type id：media id
：param seclevel：安全级别位掩码
（默认为"seclevel.none"，有关详细信息，请参见下文）。
：键入seclevel:int
：param expires:unix epoch expiration time
（默认值为``time（）+7200``（从现在起2小时））。
：键入expires:int
：param secure:``true``以获取https url。
（默认值为``false`）。
：键入secure:bool
如果seclevel参数中未指定``seclevel.delegate`
选项，则可能需要以下参数，具体取决于其他
选项。不建议这样做，因为这可能会导致虚假的
拒绝访问，主要是由于geoip数据库的差异。
：param asnum：客户端的自治系统号（默认值为"none"）。
：type asnum:str
：param ip：客户端的ip地址（默认值为"none"）。
：type ip:str
：param user agent：客户端的http用户代理头（默认值为"none"。
：键入useragent:str
示例：：
///创建一个仅限于最终用户的嵌入url，有效期为1小时
url=cloudkey.media.get_embed_url（id=media['id']，
seclevel=seclevel.delegate seclevel.asnum，
expires=time（）+3600）
``获取流URL（id，preset='mp4\u h264\u aac'，seclevel=none，
asnum=none，ip=none，useragent=none，expires=none，version=none）``
此方法将签名的URL返回到DailyMotion云视频流
（有关详细信息，请参阅API参考资料）。
生成的URL是易逝的，并且基于提供的安全级别位掩码授予访问权。
：param id:新媒体对象的ID。
：type id:media id
：param preset:所需的媒体资产预设名称
（默认为"mp4-h264-u-aac"）。
：type preset:str
：param seclevel：安全级别位掩码
（默认为"seclevel.none"，有关详细信息，请参见下文）。
：键入seclevel:int
：param expires:unix epoch expiration time
（默认值为``time（）+7200``（从现在开始的2小时））。
：键入expires:int
：param download:``true``以获取下载url
（默认值为``false`）。
：键入download:bool
：param filename：下载URL文件名。
如果设置了下载参数，则它将覆盖下载参数。
：键入filename:str
：param version：插入到URL中用于缓存刷新的任意整数。
仅在需要时使用此参数，仅当需要缓存刷新时才修改其值。
：键入version:int
：param protocol:streaming protocol（"hls"、"rtmp"、"hps"或"http"）。如果是"http"，则重写"download"参数。
：如果在seclevel参数中未指定"seclevel.delegate"选项，则可能需要以下参数，具体取决于其他选项。不建议这样做，因为这可能会导致虚假的
拒绝访问，主要是由于geoip数据库的差异。
：param asnum：客户端的自治系统号（默认值为"none"）。
：type asnum:str
：param ip：客户端的ip地址（默认值为"none"）。
：type ip:str
：param user agent：客户端的http用户代理头（默认值为"none"。
：键入useragent:str
quick-tour
==
仅限于一个
用户或一组用户。不同的（可组合的）选项是：
-``seclevel.none`：URL访问被授予所有人。
-``seclevel.asnum``：URL访问被授予指定的
作为数字。因为数字代表"自治系统号"
，并大致将IP组映射到Internet上的电信公司和大型组织（例如，每个ISP都有自己的AS号，
dailyotion的as编号是as41690）。
-``seclevel.ip``：仅向指定的ip地址授予url访问权限
。此选项可能导致虚假的拒绝访问，因为当访问Internet时，有些
用户在多个代理后负载平衡（这主要是ISP和大型
组织的情况）。
-``seclevel.useragent``：URL访问被授予用户
发送仅指定的用户代理http头。
-``seclevel.delegate``：在第一次url
访问期间，将在服务器端收集asnum、ip和用户代理值
，而不需要事先在客户端指定（这是建议的方法，因为它将
确保100%准确的asnum识别）。
-``seclevel.useonce``：只授予一次url访问
（使用此选项可能会阻止seeking正常工作）。
请参阅DailyMotion Cloud
流安全文档。
异常
----
*rpcexception:这是所有异常的基础http传输
*serializerRor：当请求或响应无效时json
*invalidRequest:当请求格式不正确时
*invalidCall:当"call"参数的值无效时
*invalidObject:当访问不存在的对象时
*invalidMethod:访问不存在的方法时
*invalidParameter:使用无效或缺少的参数调用方法时
*身份验证错误：身份验证信息无效时
*rateLimitExceeded:超过API调用数时在
特定时间段
*应用程序异常：以下异常的基类
*未找到：当对不存在的项请求操作时
*存在：当对已存在的项请求操作时
*超出限制：当达到允许的最大对象数时。
_ python sdk:http://www.dmcloud.net/doc/api/python sdk.html
。_ Cloud-API:http://www.dmcloud.net/doc/api/
。_ media-api:http://www.dmcloud.net/doc/api/cloud-api.html；媒体api
。_媒体对象：http://www.dmcloud.net/doc/api/cloud api.html；媒体api
…_文件对象：http://www.dmcloud.net/doc/api/cloud-api.html；file-api
************************************
br/>>一般信息
=================
>python库公开了《云api》一节中描述的所有api方法，这些api方法都是在《云api》一节中描述的。br/>你可以下载python库到http://github.com/dailymotion/cloudkey py>；` ` ` `.
用于特定目的的方法，如上载文件或获取签名的流URL。例如，要从"media"对象调用"list"方法，
代码如下：
api_key）
cloudkey.media.list（）
对于需要参数的方法，这些参数必须作为命名参数传递：
cloudkey.media.list（fields=['id']，per_page=20，page=2）
路径。
：param file：文件的路径
：type file:str
：返回一个dict，其中包含可以访问上载文件的"url"
：rtype:dict
对象`
^^^^^^^^^^^^^^^^^^^^
``获取嵌入URL（id，seclevel=none，asnum=none，ip=none，useragent=none，expires=none，secure=false）```
并基于
提供的安全级别位掩码授予访问权。
：param id：新媒体对象的ID。
：type id：media id
：param seclevel：安全级别位掩码
（默认为"seclevel.none"，有关详细信息，请参见下文）。
：键入seclevel:int
：param expires:unix epoch expiration time
（默认值为``time（）+7200``（从现在起2小时））。
：键入expires:int
：param secure:``true``以获取https url。
（默认值为``false`）。
：键入secure:bool
如果seclevel参数中未指定``seclevel.delegate`
选项，则可能需要以下参数，具体取决于其他
选项。不建议这样做，因为这可能会导致虚假的
拒绝访问，主要是由于geoip数据库的差异。
：param asnum：客户端的自治系统号（默认值为"none"）。
：type asnum:str
：param ip：客户端的ip地址（默认值为"none"）。
：type ip:str
：param user agent：客户端的http用户代理头（默认值为"none"。
：键入useragent:str
示例：：
///创建一个仅限于最终用户的嵌入url，有效期为1小时
url=cloudkey.media.get_embed_url（id=media['id']，
seclevel=seclevel.delegate seclevel.asnum，
expires=time（）+3600）
``获取流URL（id，preset='mp4\u h264\u aac'，seclevel=none，
asnum=none，ip=none，useragent=none，expires=none，version=none）``
此方法将签名的URL返回到DailyMotion云视频流
（有关详细信息，请参阅API参考资料）。
生成的URL是易逝的，并且基于提供的安全级别位掩码授予访问权。
：param id:新媒体对象的ID。
：type id:media id
：param preset:所需的媒体资产预设名称
（默认为"mp4-h264-u-aac"）。
：type preset:str
：param seclevel：安全级别位掩码
（默认为"seclevel.none"，有关详细信息，请参见下文）。
：键入seclevel:int
：param expires:unix epoch expiration time
（默认值为``time（）+7200``（从现在开始的2小时））。
：键入expires:int
：param download:``true``以获取下载url
（默认值为``false`）。
：键入download:bool
：param filename：下载URL文件名。
如果设置了下载参数，则它将覆盖下载参数。
：键入filename:str
：param version：插入到URL中用于缓存刷新的任意整数。
仅在需要时使用此参数，仅当需要缓存刷新时才修改其值。
：键入version:int
：param protocol:streaming protocol（"hls"、"rtmp"、"hps"或"http"）。如果是"http"，则重写"download"参数。
：如果在seclevel参数中未指定"seclevel.delegate"选项，则可能需要以下参数，具体取决于其他选项。不建议这样做，因为这可能会导致虚假的
拒绝访问，主要是由于geoip数据库的差异。
：param asnum：客户端的自治系统号（默认值为"none"）。
：type asnum:str
：param ip：客户端的ip地址（默认值为"none"）。
：type ip:str
：param user agent：客户端的http用户代理头（默认值为"none"。
：键入useragent:str
quick-tour
==
仅限于一个
用户或一组用户。不同的（可组合的）选项是：
-``seclevel.none`：URL访问被授予所有人。
-``seclevel.asnum``：URL访问被授予指定的
作为数字。因为数字代表"自治系统号"
，并大致将IP组映射到Internet上的电信公司和大型组织（例如，每个ISP都有自己的AS号，
dailyotion的as编号是as41690）。
-``seclevel.ip``：仅向指定的ip地址授予url访问权限
。此选项可能导致虚假的拒绝访问，因为当访问Internet时，有些
用户在多个代理后负载平衡（这主要是ISP和大型
组织的情况）。
-``seclevel.useragent``：URL访问被授予用户
发送仅指定的用户代理http头。
-``seclevel.delegate``：在第一次url
访问期间，将在服务器端收集asnum、ip和用户代理值
，而不需要事先在客户端指定（这是建议的方法，因为它将
确保100%准确的asnum识别）。
-``seclevel.useonce``：只授予一次url访问
（使用此选项可能会阻止seeking正常工作）。
请参阅DailyMotion Cloud
流安全文档。
异常
----
*rpcexception:这是所有异常的基础http传输
*serializerRor：当请求或响应无效时json
*invalidRequest:当请求格式不正确时
*invalidCall:当"call"参数的值无效时
*invalidObject:当访问不存在的对象时
*invalidMethod:访问不存在的方法时
*invalidParameter:使用无效或缺少的参数调用方法时
*身份验证错误：身份验证信息无效时
*rateLimitExceeded:超过API调用数时在
特定时间段
*应用程序异常：以下异常的基类
*未找到：当对不存在的项请求操作时
*存在：当对已存在的项请求操作时
*超出限制：当达到允许的最大对象数时。
欢迎加入QQ群-->： 979659372
