push api 内容更新推送接口使用指南(v2.0)新.pdfVIP

中国电信CDN 服务API 接口手册 Push API 内容更新推送接口使用指南 V2.0 2013 年01 月 用户至上·用心服务 云随你动 目录 1 功能描述： 3 2 调用说明 3 2.1 调用URL 地址 3 2.2 调用方式 3 2.3 调用提交内容格式说明 3 2.4 调用提交URL 格式要求4 3 调用反馈说明 5 3.1 调用反馈格式示例5 3.2 调用反馈detail_info 说明 5 4 调用示例代码（PHP） 6 5 版权申明 11 中国电信股份有限公司云计算分公司 网址： 电话：86-10 2/11 用户至上·用心服务 云随你动 1 功能描述： 接收用户提交的要推送的URL 或目录，生成推送任务。本接口对提交的URL 进行校验，并返回任务保存状态。中国电信根据提交的URL 进行相应推送操作。 接口调用没有生成推送任务时，只返回JSON 格式的错误信息反馈。 Push API 内容更新推送接口经过我们不同时间段测试，提交成功后，推 送页面会在最长5 分钟时间内推送完成。 2 调用说明： 2.1 调用URL 地址 /interface/push_content.php 2.2 调用方式 本接口只支持POST 方式提交调用，提交的内容为JSON 串。字符编码为UTF8 2.3 调用提交内容格式说明 提交内容示例 {user_name:,check_code:c34ccbb3f98bc332bda62 252122d50e1,url_list:[/test.php?p=1abc= 2],dir_list:[/test/]} 提交的内容分成四个部分 user_name：接口用户名 说明：接口调用，中国电信会另外开设一个接口账号，这个接口账号并不是登录 CloudCDN 客户专区的用户账号，而是在开通接口调用服务时额外开设的。在开 设接口用户（user_name)时，同时会设置接口用户KEY(即interface_key)及接口用 户密码(interface_password)，用来生成接口调用验证码。 check_code：接口调用验证码 验证码是按一定规则生成的字符串MD5 摘要値。生成规则如下： 中国电信股份有限公司云计算分公司 网址： 电话：86-10 3/11 用户至上·用心服务 云随你动 md5(yyyymmdd + username + interface_key + interface_password)，注意字符串的 顺序，生成时不需要加号。 说明： yyyymmdd 代表当天的日期，时区：chongqi 重庆 username 接口用户名 interface_key 接口用户key interface_password 接口用户密码 下面是一个组成接口调用验证码的例子，假定以下信息是中国电信提供给您的接 口账号信息并且当天日期是2011 年10 月17 日 接口用户名：ctcdndemo 接口Key：itskey 接口密码 ：password 则生成md5 的字符串应该是这样的： tcdndemoitskeypassword 假定用来生成md5 值的函数为md5()，取决您使用的语言，大多数的语言都提供 类似的函数。则程序中代码类似以下： md5_value = md5(tcdndemoitskeypassword”); url_list：要推送的文件url 列表 要推送的文件url 组织为JSON 一维数组，用[ ]来括号，每个文件URL 之间用逗 号分隔。 dir_list ：要推送的目录url 列表 要推