简介
阿里云CDN提供了丰富的API接口,除了控制台,CDN还开发了多样化的接口。目前我们推荐用户使用新版API,详情请参见新版API参考。同时CDN提供了多语言SDK工具包,并且准备了SDK使用说明,以便用户了解如何获取、安装和调用阿里云SDK。用户可以单击CDN SDK下载,并参考文档去集成。目前CDN提供的SDK如下:Java、Python、PHP、.NET、C或C++、Go。
API调用
CDN的API是RPC风格,用户可以通过发送HTTP GET请求调用API,并按照接口说明在请求中加入相应请求参数,调用后系统会返回处理结果。CDN支持通过HTTP或HTTPS通道进行请求通信,为了获得更高的安全性,推荐使用HTTPS通道发送请求。我们提供了API的调用规则,并且提供了使用Java、Python封装API的示例,具体可以参见API调用方式。
SDK调用
由于API调用需要按照调用规则去计算签名,经常会遇到一些开发者计算签名错误导致无法正常调用API的情况,建议用户直接使用SDK来调用接口,SDK里封装了接口,会自动计算签名,免去自己计算签名的困扰。用户可以直接在OpenAPI Explorer中运行接口,填写接口私有参数运行成功后,OpenAPI Explorer可以自动生成SDK代码示例,集成SDK以后调用示例代码即可。如下图,在API接口文档里单击"调试"按钮即可进入调试模式,设置参数以后调试成功可以查看示例代码。
注:接口文档提供了调用接口的错误码,如果出现错误时,可以根据具体的错误码以及错误解释查找原因,确认是否是哪个参数传的不正确。也可以参见这个CDN错误代码汇总匹配错误信息。
控制台查看接口参数
由于CDN控制台也是通过调用CDN的API接口来实现对CDN的相关操作,因此如果对于调试时调用接口的参数有疑问的时候,可以通过控制台先去设置相关的功能,然后通过打开浏览器Network去看控制台具体调用了什么接口,传了什么参数,这样方便理解以便进一步完成自己的开发工作。以刷新功能为例,在控制台刷新功能页面下打开Network,然后执行刷新工作,可以看到控制台调用了RefreshObjectCaches接口,并且在Form Data下面可以看到控制台调用该接口发的参数。具体可以看下面的图一和图二。