SparkAPI_v2.3.3.pages

Size: px

Start display at page:

Download "SparkAPI_v2.3.3.pages"

尻宣宿
1 years ago
Views:

1 Spark API 开发指南北京梦之窗数码科技有限公司版本 : 期 :

2 录 1. 概述通信约定 HTTP 法返回格式编码格式加密接访问次数限制 HTTP 接获取户信息获取视频信息批量获取视频信息获取视频播放代码编辑视频信息删除视频获取视频分类搜索视频视频件上传接 Flash 视频上传 HTTP 视频上传 ( 断点续传 ) 附录 1. HTTP 通信加密算法附录 2. Flash 和 JavaScript 交互 24

3 1. 概述利 Spark API 可以与 CC 视频 Spark 云进对接, 使 Spark 云的主要视频功能当前 Spark API 的版本具有上传播放获取视频信息获取户信息删除视频获取视频分类等接前 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"?> <error>error_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 算法的细节请参附录接访问次数限制户服务权限

4 当某个接的访问频率在分钟之内超过 100 次的时候, 该户的 API 功能将被禁, 之后所有请求都将失效如果上述阈值法满您的正常需求的时候, 可以联系 CC 客服申请提升 API 的请求频率 3. HTTP 接 3.1 获取户信息需要传递以下 : 通过该接可以获取指定户的账户信息, 地址为 : userid format 返回数据 user 包含如下字段 : account version expired space traffic space 包含如下字段 : total remain used traffic 包含如下字段 : total remain used XML 格式的返回信息如下 : 户 id, 不可为空返回格式,xml 或 json 户账户版本信息到期时间户空间信息户流量信息户空间总量, 单位 G 户空间剩余总量, 单位 G 户空间使总量, 单位 G 户流量总量, 单位 G 户剩余流量, 单位 G 户已使流量, 单位 G

5 <?xml version="1.0" encoding="utf-8"?> <user> <version><[cdata[ 试版 ]]></version> <expired> </expired> <space> <total>2</total> <remain>1.9</remain> <used>0.1</used> </space> <traffic> <total>5</total> <remain>4.8</remain> <used>0.2</used> </traffic> </user> JSON 格式的返回信息如下 : { "user":{ "account":"test@test.com", "version":" 试版 ", "expired":" ", "space":{ "total":2, "remain":1.9, "used":0.1, "traffic":{ "total":5, "remain":4.8, "used": 获取视频信息 a. 当地址为需要传递以下 : 通过该接可以获取指定户的有效视频的信息, 地址为 : userid videoid format 返回数据 video 包括如下字段 : id title 户 id, 不可为空视频 id, 不可为空返回格式,xml 或 json 视频 ID 视频标题

6 desp tags duration category image imageindex image-alternate image-alternate 包括如下字段 : index url XML 格式的返回信息如下 : 视频描述视频标签视频时, 单位秒视频分类 ID 视频截图地址视频截图序号视频截图排列信息视频截图排列序号视频截图地址 <?xml version="1.0" encoding="utf-8"?> <video> <id> </id> <title><[cdata[ 视频标题 ]]></title> <desp><[cdata[ 视频描述 ]]></desp> <tags><[cdata[ 标签 1 标签 2 标签 3]]></tags> <duration>12345</duration> <category>12345</category> <image> <imageindex>1</imageindex> <image-alternate> <index>0</index> <url> </image-alternate> <image-alternate> <index>1</index> <url> </image-alternate>... </video> JSON 格式的返回信息如下 :

7 { "video":{ "id":" ", "title":" 视频标题 ", "desp":" 视频描述 ", "tags":" 标签 1 标签 2 标签 3", "duration":12345, "category":"12345", "image":" "imageindex":1, "image- alternate":[{ "index":0, "url":" ] b. 当地址为需要传递以下 userid videoid format 返回数据 video 包括如下字段 : id title desp tags duration category image imageindex image-alternate definition image-alternate 包括如下字段 : index 户 id, 不可为空视频 id, 不可为空返回格式,xml 或 json 视频 ID 视频标题视频描述视频标签视频时, 单位秒视频分类 ID 视频截图地址视频截图序号视频截图排列信息视频件信息视频截图排列序号

8 url definition 包括如下字段 : definitionlevel definitiondesc 视频截图地址视频清晰度值视频清晰度描述 terminaltype 终端类型 (0:PC 端,10: 移动端 ) filesize XML 格式的返回信息如下 : 视频件 <?xml version="1.0" encoding="utf-8"?> <video> <id> </id> <title><[cdata[ 视频标题 ]]></title> <desp><[cdata[ 视频描述 ]]></desp> <tags><[cdata[ 标签 1 标签 2 标签 3]]></tags> <duration>12345</duration> <category>12345</category> <image> <imageindex>1</imageindex> <image-alternate> <index>0</index> <url> </image-alternate> <image-alternate> <index>1</index> <url> </image-alternate> <definition> <definitionlevel>0</definitionlevel> <definitiondesc> 普通 </definitiondesc> <terminaltype>0</terminaltype> <filesize> </filesize> </definition> </video> JSON 格式的返回信息如下 :

9 { "video":{ "id":" ", "title":" 视频标题 ", "desp":" 视频描述 ", "tags":" 标签 1 标签 2 标签 3", "duration":12345, "category":"12345", "image":" "imageindex":1, "image- alternate":[{ "index":0, "url":" ], "definition":[{ "definitionlevel": 2, "definitiondesc": " 清 ", "terminaltype": 0, "filesize": , ] 3.3 批量获取视频信息 a. 当地址为需要传递以下 : 通过该接可以获取指定户的批有效视频 ( 不包括删除正在处理的视频 ) 的信息, 地址为 : userid videoid_from videoid_to 户 id, 不可为空起始 videoid, 若为空, 则从上传的第个视频开始终 videoid, 若为空, 则到最后个上传的视频 num_per_page 返回信息时, 每包含的视频个数注 : 允许范围为 1~100 page 当前码 format 返回数据 videos 包含以下字段 : 返回格式,xml 或 json total video video 包含以下字段 : 返回视频数量视频信息

10 id title desp tags duration category image imageindex 视频 ID 视频标题视频描述视频标签视频时, 单位秒视频分类 ID 视频截图地址视频截图序号 image-alternate image-alternate 包含以下字段 : 视频截图排列信息 index url XML 格式的返回信息如下 : 视频截图排列序号视频截图地址 <?xml version="1.0" encoding="utf-8"?> <videos> <total>100</total> <video> <id> </id> <title><[cdata[video Title]]></title> <desp><[cdata[video Description]]></desp> <tags><[cdata[tag1 tag2 tag3]]></tags> <duration>12345</duration> <category>12345</category> <image> <imageindex>1</imageindex> <image-alternate> <index>0</index> <url> </image-alternate> <image-alternate> <index>1</index> <url> </image-alternate>... </video>... </videos> JSON 格式的返回信息如下 :

11 { "videos":{ "total":100, "video":[ { "id":" ", "title":"video Title", "desp":"video Description", "tags":"tag1 tag2 tag3", "duration":12345, "category":"12345", "image":" "imageindex":1, "image-alternate":[ { "index":0, "url":" ], ] b. 当地址为需要传递以下 : userid videoid_from videoid_to 户 id, 不可为空起始 videoid, 若为空, 则从上传的第个视频开始终 videoid, 若为空, 则到最后个上传的视频 num_per_page 返回信息时, 每包含的视频个数注 : 允许范围为 1~100 page 当前码 format 返回数据 videos 包含以下字段 : 返回格式,xml 或 json total video video 包含以下字段 : id title 返回视频数量视频信息视频 ID 视频标题

12 desp tags duration category image imageindex image-alternate 视频描述视频标签视频时, 单位秒视频分类 ID 视频截图地址视频截图序号视频截图排列信息 definition image-alternate 包含以下字段 : 视频件信息 index url definition 包含以下字段 : definitionlevel definitiondesc 视频截图排列序号视频截图地址视频清晰度值视频清晰度描述 terminaltype 终端类型 (0:PC 端,10: 移动端 ) filesize XML 格式的返回信息如下 : 视频件

13 <?xml version="1.0" encoding="utf-8"?> <videos> <total>100</total> <video> <id> </id> <title><[cdata[video Title]]></title> <desp><[cdata[video Description]]></desp> <tags><[cdata[tag1 tag2 tag3]]></tags> <duration>12345</duration> <category>12345</category> <image> <imageindex>1</imageindex> <image-alternate> <index>0</index> <url> </image-alternate> <image-alternate> <index>1</index> <url> </image-alternate> <definition> <definitionlevel>0</definitionlevel> <definitiondesc> 普通 </definitiondesc> <terminaltype>0</terminaltype> <filesize> </filesize> </definition> </video>... </videos> JSON 格式的返回信息如下 :

14 { "videos":{ "total":100, "video":[ { "id":" ", "title":"video Title", "desp":"video Description", "tags":"tag1 tag2 tag3", "duration":12345, "category":"12345", "image":" "imageindex":1, "image-alternate":[ { "index":0, "url":" ], "definition":[ { "definitionlevel": 2, "definitiondesc": " 清 ", "terminaltype": 0, "filesize": , ], ] 3.4 获取视频播放代码需要传递以下 : 通过该接可以获取指定视频的视频播放 HTML 代码段, 地址为 : videoid userid playerid player_width player_height auto_play format 返回数据 video 包含以下字段 : 视频 id, 不可为空户 id, 不可为空播放器 id, 若为空则返回默认播放器播放器宽度, 单位 px 播放器度, 单位 px 是否动播放,true 或 false 返回格式,xml 或 json

15 playcode XML 格式的返回信息如下 : 嵌的播放代码 <?xml version="1.0" encoding="utf-8"?> <video> <playcode> <[CDATA[<script src=' vid= c315e6a9&siteid=1936d297411c3a27&autostart=false&width=600&height=490&playerid =6ED7421AB96B522E&playertype=1' type='text/javascript'></script>]]> </playcode> </video> JSON 格式的返回信息如下 : { "video":{ "playcode":"<script src=' vid= c315e6a9&siteid=1936d297411c3a27&autostart=false&width=600&height=490&playerid =6ED7421AB96B522E&playertype=1 type='text/javascript'></script>" 3.5 编辑视频信息需要传递以下 : 通过该接可以编辑指定视频的信息, 地址为 : videoid userid title tag description categoryid playurl 视频 id, 不可为空户 id, 不可为空视频标题视频标签视频描述视频分类 id 视频播放地址, 如果不编辑播放地址, 请勿加此 imageindex 视频封截图序号, 如果不编辑封截图, 请勿加此注 : 只可编辑正常可播放状态的视频截图 format 返回数据 video 包含如下字段 : id 返回格式,xml 或 json 视频 ID

16 title desp tags category playurl imageindex XML 格式的返回信息如下 : 视频标题视频描述视频标签视频分类 ID 视频播放地址视频截图序号 <?xml version="1.0" encoding="utf-8"?> <video> <id> </id> <title><[cdata[video Title]]></title> <desp><[cdata[video Description]]></desp> <tags><[cdata[tag1 tag2 tag3]]></tags> <category>12345</category> <playurl> <imageindex>1</imageindex> </video> JSON 格式的返回信息如下 : { "video":{ "id":" ", "title":"video Title", "desp":"video Description", "tags":"tag1 tag2 tag3", "category":"12345", "playurl":" "imageindex":1 3.6 删除视频需要传递以下 : 通过该接可以删除指定视频的信息, 地址为 : videoid userid format XML 格式的返回信息如下 : 视频 id, 不可为空户 id, 不可为空返回格式,xml 或 json

17 <?xml version="1.0" encoding="utf-8"?> <result>ok</result> JSON 格式的返回信息如下 : { "result":"ok" 3.7 获取视频分类需要传递以下 : 通过该接可以获取指定户创建的全部视频分类, 地址为 : userid 户 id, 不可为空 format 返回格式,xml 或 json 注 : 返回结果中的 level 包括 BASIC 和 PREMIUM,BASIC 中只包含个默认分类, 法创建定义分类, PREMIUM 版本中包含户创建的分类返回数据 video 包含如下字段 : level category category 包含如下字段 : id name sub-category sub-category 包含如下字段 : id name XML 格式的返回信息如下 : 视频分类等级视频分类信息分类 ID 分类名称分类信息分类 ID 分类名称

18 <?xml version="1.0" encoding="utf-8"?> <video> <level>basic</level> <category> <id>123</id> <name><[cdata[category1]]></name> <sub-category> <id>456</id> <name><[cdata[sub category1]]></name> <sub-category>... </category>... </video> JSON 格式的返回信息如下 : { "video":{ "level":"premium", "category":[{ "id":123, "name":"category1", "sub-category":[{ "id":456, "name":"sub category1",... ],... ] 3.8 搜索视频需要传递以下 : 通过该接可以搜索指定信息的视频, 地址为 : userid 户 id, 不可为空 q 查询条件, 不可为空格式 : 查询字段 : 查询内容查询字段 : 前只持 TITLE 查询内容 : 查询关键字注 : 格式中的 : 为英半 Example:q=TITLE:test

19 sort 查询结果排序, 不可为空格式 : 排序字段 : 排序式排序字段 :CREATION_DATE 或 FILE_SIZE 排序式 :ASC 或 DESC 注 : 格式中的 : 为英半 Example:sort=CREATION_DATE:DESC categoryid 视频分类 id, 如果不查询指定分类下的视频, 请勿加此 num_per_page 返回信息时, 每包含的视频个数注 : 阈值为 1~100 page 当前码 format 返回数据 videos 包含如下字段 : 返回格式,xml 或 json total video video 包含如下字段 : id title desp tags duration category creation-date filesize image XML 格式的返回信息如下 : 返回视频数量视频信息视频 ID 视频标题视频描述视频标签视频时, 单位秒视频分类 ID 视频创建时间视频件, 单位字节视频截图地址

20 <?xml version="1.0" encoding="utf-8"?> <videos> <total>100</total> <video> <id> </id> <title><[cdata[video Title]]></title> <desp><[cdata[video Description]]></desp> <tags><[cdata[tag1 tag2 tag3]]></tags> <duration>12345</duration> <category>12345</category> <creation-date> :16:50</creation-date> <filesize> </filesize> <image> </video>... </videos> JSON 格式的返回信息如下 : 4. 视频件上传接 4.1 Flash 视频上传 Spark API 中所有的 Flash 接需要 Flash 插件的版本在 10.1 以上才有效, 使前请确保 Flash 插件版本符合要求在上传视频的过程中, 不与 Spark 平台进 HTTP 通信, 使 JavaScript 和 Spark 平台提供的 Flash 进交互即可完成关于如何在中嵌 Flash 以及如何和 Flash 进交互, 请参阅附录 2 上传接到的所有 JavaScript 函数定义下表 : { "videos":{ "total":100, "video":[ { "id":" ", "title":"video Title", "desp":"video Description", "tags":"tag1 tag2 tag3", "duration":12345, "category":"12345", "creation-date":" :16:50", "filesize": , "image":" ] 函数定义 on_spark_selected_file(file_name, file_size) file_name: 上传件名 file_size: 上传的件, 单位字节

21 函数定义 on_spark_upload_validated(status, videoid) status: 验证结果 videoid: 视频 id on_spark_upload_progress(progress) 嵌 Spark 平台提供的上传 Flash 时, 需要传递下列 : Flash (flashvars) progress: 上传进度正确时,0~100 之间的整数, 包括 0 和 100; 错误时, 返回 -1. progress_interval 回调进度函数的时间间隔, 默认 1 秒 notify_url 上传件的过程共分为四步 : 第步, 选择件 Spark 平台提供个透明的 Flash 进件上传, 地址如下 : 由于它是透明的, 所以可以置于任何个 HTML 元素的上不影响的视觉效果上传件时, 必须通过点击到该 Flash 从打开浏览对话框进件选择件选择成功后,Flash 会调中的 on_spark_selected_file 函数, 可以选择合适的式处理该事件第步, 验证当户选择件后, 需将下的按照 THQS 算法处理后传递给 Flash 的 start_upload 函数后, 才能开始上传流程先要进和权限的验证, 通过后才开始件上传视频处理完毕后的通知地址 userid title description tag 户 id, 不可为空视频标题, 若为空, 则采去后缀件名作为 title 视频简介, 可以为空视频标签, 可以为空 categoryid 视频分类 id, 可选验证完成后,Flash 会调 on_spark_upload_validated 函数传递验证结果以及视频 id 验证状态码的含义如下 : 验证状态码 OK NETWORK_ERROR 其它第三步, 件上传成功络错误 Spark API 错误码

22 件开始上传后,Flash 会周期性调 on_spark_upload_progress 函数来报告上传进度, 间隔秒数由 progress_interval 指定如果上传的进度为负数, 则发络错误, 上传中断返回 100 则表上传成功当返回 100 或者 -1 后,Flash 就不再调该函数了第四步, 回调当处理完毕视频后 ( 上传转码审核都完成后 ),Spark 平台会通过由 notify_url 指定的 HTTP/HTTPS 地址以 GET 式发起回调若户站地址使 HTTPS 协议进数据安全传输时, 户需保证其拥有的 CA 证书是合法的户指定的 notify_url 符合以下四种 notify_url 格式之即为合法 : 为户定义的 ) Spark 仅持带有个户定义的 notify_url, 若 notify_url 中携带有户定义的, 则在进回调通知时会将户定义的和下表中的起以 THQS 式进加密 videoid status 视频 id,16 位 hex 字符串视频状态 OK 表视频处理成功, FAIL 表视频处理失败视频处理失败有多种情况, 例如视频件异常视频内容违规等等 <?xml version="1.0" encoding="utf-8"?> <result>ok</result> 当 notify_url 指定的接返回上述 XML 时,Spark 平台会认为站已经成功接收到了回调信息, 不再进重试返回其它任何内容,Spark 平台会进回调重试, 重试的间隔会随着重试次数的增增若重试 7 次后, 依然没有成功, 则不再进通知因此,Spark 平台最多通知 8 次这 8 次的通知时间距第次的通知时间的差分别为 : duration ( 单位 : 秒 ) image [0,15s, 1m, 4m, 16m, 1h4m, 4h16m, 17h4m] 4.2 HTTP 视频上传 ( 断点续传 ) 此段档于指导使 CC 视频云平台 HTTP_API 接编码来完成上传视频件功能 userid 户 CC 视频云平台账号 ccvid 或 vid 户视频件 ID CC 视频云平台指定 apikey 户 CC 视频云平台 API 的密钥 key 使步骤视频截图地址 1 户调创建视频上传信息返回数据, 并提取 vid,metaurl,chunkurl 等返回数据 2 户调上传视频 META 信息 (metaurl) 将件描述等信息发送到服务器 3 户反复调上传视频件块 CHUNK(chunkurl) 将件实际数据发送到服务器直到全部发完 4 如果调上传视频件块 CHUNK(chunkurl) 中间出现中断, 可使断点续传式上传视频 META 信息 (metaurl) 获取已发件度后继续调上传视频件块 CHUNK(chunkurl) 将件发送完成

23 流程图 1 创建视频上传信息通过该接获取视频 VID, 上传 URL 等信息此接为后续调提供需使 THQS 算法将处理需要传递以下 : 含义 userid title tag 户 id, 不可为空视频标题视频标签

24 含义 description 视频描述 categoryid 级分类 id( 主账号可选, 帐号不可为空 ) filename filesize notify_url 视频件名视频件视频处理完毕的通知地址 format 返回信息,xml 格式如下 : 返回信息,json 格式如下 : 异常返回格式 XML 格式返回格式 : 包含 xml 和 json <?xml version="1.0" encoding="utf-8"?> <uploadinfo> <videoid>3b35ed608474b8db2bb</videoid> <userid>40ef004a6f1</userid> <servicetype>240593f08</servicetype> <metaurl><[cdata[ <chunkurl><[cdata[ </chunkurl> </uploadinfo> { "uploadinfo": { "videoid": "3B35ED608474B8DB2BBA", "userid": 40EF004A6F", "servicetype": F089", "metaurl": "chunkurl": " <? xml version="1.0" encoding="utf-8"?> <error>service_expired</error> JSON 格式 { "error":" SERVICE_EXPIRED " 错误码的定义如下表 : 错误码含义 INVALID_REQUEST SPACE_NOT_ENOUGH 户输错误户剩余空间不

25 错误码含义 SERVICE_EXPIRED PROCESS_FAIL TOO_MANY_REQUEST 户服务终服务器处理失败访问过于频繁 PERMISSION_DENY 2 上传视频 META 信息需要传递以下 : 通过以下接可以发送视频件到平台接收服务器 : 户服务权限含义 uid 户 id, 不可为空断点续传请求时为可选 ccvid 视频件 vid 不可为空返回信息, 内容统含义如下 result 结果成功 (0) 失败 (-1) msg 消息信息错误描述 received 已接收件度范围 0 到件 xml 格式如下 : first 是否次 first=1 表次断点续传为次 first=2 filename 视频名称断点续传请求时为可选 md5 视频件 md5 断点续传请求时为可选 filesize 视频件单位 Byte 断点续传请求时为可选 servicetype servicetype 来源于创建视频上传信息接断点续传请求时为可选 format <?xml version="1.0" encoding="utf-8"?> <root> <result>0</result> <msg>success</msg> <received>0</received> </root> 返回信息,json 格式如下 : 返回格式 : 包含 xml 和 json 可选不选默认 json 返回

26 异常返回格式 xml 格式如下 : 返回信息,json 格式如下 : 3 上传视频件块 CHUNK { "result": 0, "msg": success", "received": 0 <?xml version="1.0" encoding="utf-8"?> <root> <result>-1</result> <msg> 件写错误 </msg> <received>-1</received> </root> { "result": -1, "msg": 件写错误 ", "received": -1 需要传递以下 : 含义 ccvid vid, 视频 id 不可为空 format 返回信息, 内容统含义如下 result 结果成功 (0) 失败 (-1) msg 消息信息错误描述 received 已接收件度范围 0 到件 xml 格式如下 : 返回格式 : 包含 xml 和 json 可选不选默认 json 返回

27 <?xml version="1.0" encoding="utf-8"?> <root> <result>0</result> <msg>success</msg> <received> </received> </root> 返回信息,json 格式如下 : 异常返回格式 xml 格式如下 : 返回信息,json 格式如下 : { "result": 0, "msg": success", "received": "412432" <?xml version="1.0" encoding="utf-8"?> <root> <result>-1</result> <msg> 件写错误 </msg> <received>-1</received> </root> { "result": -1, "msg": 件写错误 ", "received": -1" 此接使 POST 式将实际件的指定部分进制数据发送到服务器, 服务器会返回已接收到的实际件度, 当服务器返回件度等于发送件度时即件已发送完成 POST 协议详解例 HTTP 协议需要户修改 header 中 Content-Range 内容 Content-Range: bytes x-y/z x 表该段数据在件中的开始位置 == 上次请求返回 received 数值 y 表该段数据在件中的结束位置 z 表件总度提醒 :y 表件索引下标位置, 所以有 y <= z - 1 (binary) 部分为件部分块进制内容 ##### 报格式 POST /servlet/uploadchunk HTTP/1.1

28 Accept: text/* Content-Type:multipart/form-data; boundary= ij5gi3gi3ei4gi3ei4km7gi3km7km7 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4) Host: Content-Length: 421 Connection: Keep-Alive Cache-Control: no-cache Content-Range: bytes 0-100/ Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7 Content-Disposition: form-data;name="file";filename="myfile.jpg" Content-Type: application/octet-stream (binary) Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7-- 例代码 Java 版本代码上传视频件块 CHUNK 接 3 例代码 /* url 为 /servlet/uploadchunk?ccvid=&format= */ /* chunkstart 为 chunk 起始位置 */ /* chunkend 为 chunk 结束位置 */ /* file 为件 */ /* bufferout 为实际件输出进制内容 */ public String uploadchunk(string url, int chunkstart, int chunkend, File file, byte[] bufferout) { HttpURLConnection conn = null; try { String BOUNDARY = " CCHTTPAPIFormBoundaryEEXX" + new Random().nextInt(65536); // 定义数据分隔线 URL openurl = new URL(url); conn = (HttpURLConnection)openUrl.openConnection(); // 发送 POST 请求必须设置如下两 conn.setdooutput(true); conn.setdoinput(true); conn.setusecaches(false); conn.setrequestmethod("post"); conn.setrequestproperty("connection", "Keep-Alive"); conn.setrequestproperty("user-agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_4)"); conn.setrequestproperty("charsert", "UTF-8"); conn.setrequestproperty("content-type", "multipart/form-data; boundary=" + BOUNDARY); // content-range conn.setrequestproperty("content-range", "bytes " + chunkstart + "-" + chunkend + "/" + file.length()); OutputStream out = new DataOutputStream(conn.getOutputStream()); StringBuilder sb = new StringBuilder(); sb.append("--").append(boundary).append("\r\n"); sb.append("content-disposition: form-data;name=\"file" + file.getname() + "\";filename=\"" + file.getname() + "\"\r\n"); sb.append("content-type: application/octet-stream\r\n"); sb.append("\r\n"); byte[] data = sb.tostring().getbytes(); out.write(data); out.write(bufferout);

29 out.write("\r\n".getbytes()); // 定义最后数据分隔线 byte[] end_data = ("--" + BOUNDARY + "--\r\n").getbytes(); out.write(end_data); out.flush(); out.close(); // 定义 BufferedReader 输流来读取 URL 的响应 BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream())); StringBuffer resultbuf = new StringBuffer(""); String line = null; while ((line = reader.readline()) = null) { resultbuf.append(line); reader.close(); conn.disconnect(); return resultbuf.tostring(); catch (Exception e) { System.out.println(" 发送 POST 请求出现异常 " + e); e.printstacktrace(); finally { if (conn = null) conn.disconnect(); return null; 附录 1. HTTP 通信加密算法当需要和 Spark 平台进 HTTP 通信时, 需要将原始的 Query String 转换为和请求时刻相关的 Hashed Query String 后再通过 GET 法请求 Spark API 为了描述的便, 我们将 Query String 转换为 Hashed Query String 的算法称为 THQS 算法在描述详细的算法流程之前, 我们先介绍下 Unix 时间戳的概念 Unix 时间戳, 即该时间到 1970 年 1 1 (UTC/GMT 的午夜 ) 之间的秒数例如, 北京时间 2010 年点 23 分 12 秒的 Unix 时间戳为 THQS 算法假设原来的 QueryString 为 q, 通过以下 4 个步骤, 即可得到最终于通信的 HashedQueryString: 1. 对于 q 中的每个键值对按照键的字顺序升序排序, 得到排序后的请求字符串 qs; 2. 加当前时间的 Unix 时间戳和 Spark 平台帐号对应的 API Key 值, 得到散列前的字符串 qf: qf qs&time=12345&salt=asdf 计算得到 qf 的 md5 值, 假设为 abcdefg hash md5(qf) 4. 最终的 HashedQueryString 为 : hqs qs&time=12345&hash=abcdefg hqs 代替 q 进 Http 通信下举个例计算过程假设户从 Spark 获取到的 API Key 值是 asdf1234, 当前时间为 2010 年点 23 分 12 秒, 原始的 QueryString 是 name=harry&level=top&salary=1000

30 Spark API 开发指南第步, 将上述 QueryString 按照字顺序进升序排序, 结果是 level=top&name=harry&salary=1000 第步, 附加 time 值和 salt 值, 得到取 hash 前的字符串 level=top&name=harry&salary=1000&time= &salt=asdf1234 第三步, 对上述字符串取 md5 值 hash=bf04a55b30cff562f7add9f054ab7ffb 因此, 最终进 Http 通信的字符串为 level=top&name=harry&salary=1000&time= &hash=bf04a55b30cff562f7add9f054ab7ffb 附录 2. Flash 和 JavaScript 交互 Spark 平台的通信模式中, 有若干种式需要通过与中嵌的 Flash 交互完成 Flash 和有多种式可以交互, 为了保证 Spark 平台提供的 Flash 能够在各种环境下都能正常作, 推荐采以下式进处理先, 需要将 swf 件嵌到中, 推荐采 swfobject 1.5 版本将 swfobject.js 添加到中后, 以下 js 语句将 swf 嵌到中, <script type="text/javascript"> var swfobj=new SWFObject(' 'swfname', '80', '80', '8'); swfobj.addvariable('title','test'); swfobj.addvariable('number', 123); swfobj.addparam('allowfullscreen','true'); swfobj.addparam('allowscriptaccess','always'); swfobj.addparam('wmode','transparent'); swfobj.write('divid'); </script> 其次, 调 Flash 中的函数的时候, 如果 Flash 提供的函数名叫 func, 需要传递的是 param 的话, 那么下这句就可以调该函数 swfname["func"](param); 其中,swfname 是嵌 Flash 的 id 值

SparkAPI_开发指南_v2.1.4.pages

SparkAPI_开发指南_v2.1.4.pages Spark API 开发指南北京梦之窗数码科技有限公司版本 : 2.1.4 日期 : 2014-03-21 目录 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 获取视频信息...