开发者学堂课程【阿里云HTTP DNS使用教程:HTTPDNS-API 的说明】学习笔记,与课程紧密联系,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/408/detail/5251
HTTPDNS 的 API 的说明
内容介绍:
一、HTTPDNS 的 API 的使用
1. API 的访问说明
2. 域名解析
3. API 的响应说明
4.快速接入
一、HTTPDNS 的 API 的使用
我们进入到官网详情页,然后点击管理控制台。进入到控制台里面过后,看到这里有一个如何使用 HTTPDNS ,点击进入到这个快速开始,那么在快速开始的左侧,我们能看到一系列的文档,我们找到 APP API 的手册,那么对于我们那个服务器的开发和一些相应工作来说的话,最主要的话就是这个部分的一些文档工作。
那么在这里我们为了保证它的安全性和一些稳定性,我们这里会有一个提示。所以就是在使用 HTTPDNS 的时候,务必包含降级处理逻辑,就是以应对没有获取到解析结果的情况下的一些处理的风险。
另外的话,就是优先使用官方的 SDK ,如果直接你要调用 HTTP API 的访问,考虑到就是说攻击的因素,不要固定使用单个的服务 IP 。来去解析这个域名,否则的话,可能会遭到攻击后会很难的去规避这个风险
1. API 的访问说明
访问方式,我们一般是通过这个 get 方法来去获取这个域名解析的结果,那么我们目前在官网上提供的这个203的这个域名的话,是不是唯一的我们会有多个服务器的这种解析的域名。
然后另外一点我们还需要注意,就是 HTTP GET 方法和 HTTPS GET 的方法的话,这两个是有差异的。就是一次 HTTPS 的一个解析请求的话,那就相当于五次的 HTTP ,这个是我们是进行了有一个起飞的说明。
具体的差异,这里列出每次通过 HTTPS 接口进行域名解析,折算成五次 HTTP 接口。
2.域名解析
这里有对应的一个信息,那么直接在浏览器里面输入就可以去进行一个域名的一个获取,这两个都一样。那么这个 account ID 是什么?这个文档也有说明,点击过后在这里会有一个解释,就是我们在控制台看到的 occount 的 ID 。
我们现在提供的这种方式的一次请求只能解析一个域名,就不能多个,另外的话,我们文章中提到的主要域名是这个,所以也一定要注意一点。
另外,HTTPDNS 提供安卓 SDK 和 SDK 的一个基层。所以尽量的话就用我们 SDK 提供的这种包来进行集成。
3.API 的响应说明
当你请求的时候返回一个参数结构,这个的话会关系到你的数据如何去解析、你如何去使用,所以这里我们也给出了一个详尽的说明。然后以及请求过程中发生错误过后的错误码和对应的一个说明,说明如下:
请求成功时,HTTP 响应状态码为200,响应结果用 JSON 格式表示,示例如下:
{
host”:”www.aliyun.com”,
ips”:[
140.205.140.234”
] ,
“ttl”:57,
“origin_ttl”:120
}
然后如果发生错误过后的话,我们一般提供了几种处理方式:异步请求以及采用冲刺和降级三种方式来处理。
4. 快速接入
快速接入的话,我们提供了安卓的 IOS 的 DEMO,然后以及对应的接入的文档。然后注意就是 HTTP 请求 host 的字段的设置一定要按照我们的说明来进行一个对应的配置。
我们还提供了在左边提供了一个批量解析的域名的一个 API 的一个接口,就批量解析的接口,那么这个批量解析的话,当时请求也最多只是允许你五个。就是采用逗号进行分割。然后 API 的响应格式这里列出来了。
可以做一个参考,HTTPAPI 的手册,主要是因为我们接入的时候用到的,而这上面的open API 的手册主要适用于控制台管理的。
控制台管理的话,就是说我们添加域名,删除域名,获取域名列表,就方便你去管理,这里是怎么去理解?
这个 open API 手册实际上就是在这里所谓的添加域名。删除管理整个域名的一个情况所使用的 API ,所以这个一定要区分清楚。所以比如说获取域名的一个列表,三个域名的一些具体的情况,他的查询次数,这个是方便你自己去管理你的整个数据信息而使用的一个 API 的手册,所以这个部分不是我们在接入的时候所用到的,所以这里面是有差异性的,一定要注意这一点。