ChinaCache CDN内容刷新API V5.1接口文档

"该文档是关于ChinaCache刷新V5.1 API的接口文档，由北京蓝汛通信技术有限责任公司于2014年2月发布。文档详细介绍了如何使用此API进行内容刷新请求的提交和结果查询，以及相关的调用方式、参数说明和示例。" **1. 蓝汛刷新API简介** 蓝汛刷新API，即R5.1 API，是ChinaCache提供的CDN内容管理系统接口，允许用户通过API提交内容刷新请求并查询请求结果。系统针对不同类型的刷新任务设定了提交限制，例如一般用户每小时最多可提交10000条URL刷新任务和100条目录刷新任务，以保护服务器资源。 **2. 提交刷新** - **提交地址**: 用户可以通过`https://r.chinacache.com/content/refresh`这个URL提交刷新请求。 - **调用方式**: 使用HTTP POST方法进行调用。 - **响应方式**: 响应结果以HTTP状态码表示，具体信息以JSON格式返回。 - **结果反馈**: 如果在请求中指定了callback参数，结果将以POST方式异步反馈到指定地址，仅在执行成功或失败时反馈，不提供中间状态。 **3. 参数说明** - **username**: 刷新功能的账户名或主账户名。 - **password**: 对应账户的密码。 - **task**: 刷新任务，包含URL列表和目录列表，如`urls`和`dirs`，以及可选的`callback`参数，用于接收反馈结果的URL和邮件地址。 **4. 示例** - 提交请求示例展示了如何以JSON格式发送参数。 - 查询请求示例包括设置SSL环境、运行Java程序来访问R5.1 API的步骤。 **5. 结果查询** - **查询地址**: 另一个API接口用于查询刷新请求的结果。 - **调用方式**: 同样使用HTTP POST方法。 - **参数说明**: 查询请求也包含特定的参数，如任务ID等。 - **结果说明**: 返回的结果同样以JSON格式呈现，包含刷新请求的状态和详情。 通过这些详细说明，开发者可以集成ChinaCache的刷新服务到他们的应用程序中，自动化处理内容刷新任务，提高网站内容更新的效率。