SparkAPI开发指引-CC视频.PDF

Spark API 开发指南 Spark API 开发指南 版本: 2.0.3 ⽇期: 2012-11-20 北京梦之窗数码科技有限公司 Spark API 开发指南 ⺫ 录 1. 概述1 2. 通信约定1 2.1 Http⽅法1 2.2 返回格式1 2.3 编码格式1 2.4 加密1 2.5 接⼝访问次数限制2 3. Http接⼝2 3.1 获取⽤户信息2 3.2 获取视频信息2 3.3 批量获取视频信息3 3.4 获取视频播放代码5 3.5 编辑视频信息6 3.6 删除视频7 3.7 获取视频分类7 4. Flash接⼝8 4.1 视频上传8 4.2 视频播放10 附录 1. Http通信加密算法12 附录 2. Flash和Javascript交互12 Spark API 开发指南 1. 概述 利⽤ Spark API 可以与 CC 视频 Spark 云进⾏对接，使⽤ Spark 云的主要视频功能。当前 Spark API 的版本 号为 2.0 ，具有上传、播放、获取视频信息、获取⽤户信息、删除视频、获取视频分类等接⼝。 ⺫前 Spark API 仅对合作⽅开启，如果您有使⽤的需求，请通过 CC 视频后台申请 API Key ，通过审核后才能 使⽤ Spark API 。 2. 通信约定 Spark API 的远程通信接⼝基于 Http 协议，并有以下约定： 2.1 Http⽅法 所有接⼝采⽤ GET 请求。 2.2 返回格式 接⼝的返回格式包括 XML 格式和 JSON 格式，编码均为 UTF-8 。对于不同的接⼝，正确的返回结果的格式会 在每个接⼝中单独定义，错误的返回结果具有统⼀的形式，如下所⽰： ?xml version=1.0 encoding=UTF-8? errorERROR_CODE/error { “error” :”ERROR_CODE” } 实际中，下表中的某⼀个具体的错误码会替换掉上⾯的ERROR_CODE ： 错误码 说明 INVALID_REQUEST ⽤户输⼊参数错误 SPACE_NOT_ENOUGH ⽤户剩余空间不⾜ SERVICE_EXPIRED ⽤户服务已经过期 PROCESS_FAIL 服务器处理失败 TOO_MANY_REQUEST 访问过于频繁 PERMISSION_DENY ⽤户服务⽆权限 2.3 编码格式 Spark API 只接受 UTF-8 格式编码的信息，返回的数据也都是 UTF-8 编码的。当需要通过 GET 请求传递参数 时，QueryString ⾥⾯的 value 值都需要进⾏ URL Encode 之后，再进⾏传递。 2.4 加密 所有的 HTTP 通信都是加密的，加密的核⼼思想是将原始的 QueryString 转换为和请求时间相关的 HashedQueryString ，我们称这个加密算法为 THQS 算法。关于 THQS 算法的细节请参⻅附录 1 。 第 1 ⻚共 13 ⻚ Spark API 开发指南 2.5 接⼝访问次数限制 当某⼀个接⼝的访问频率在⼀分钟之内超过100次