HTTPdns方案(修正6)

1、HTTP DNS 方案修订记录时间修订人修订内容备注2015-11-10杨波根据邓谦、颜昀方案以及讨论结果初稿2015-11-11杨波会议讨论修正2015-11-12杨波修订接口1,2,修订流程图2015-11-20杨波调整接口1返回内容； 接口2请求串加eip, 返回串device_isp, device_ip 提到顶级2015-12-02曹望接口3删除“播放类型标记”字段,新增接口5 2015-12-03杨波接口2 请求串eip取消,所有出现dns的请求字段改成hd2015-12-04杨波接口2 原来用http:/【httpdnsservice】/hd 改成 http:/【httpdnss

2、ervice】/dns ;接口3,4,5 需要加info.php 提交一、 名词解释名称解释备注CMS媒资接口HTTP DNS servicehttp dns 服务APP(android phone移动端) 应用程序二、 目的为解决业务URL的DNS劫持问题，设计该方案。 三、 方案说明3.1基本流程App向HTTPDNS 服务请求查询到业务url对应IP后，用IP发起业务访问，具体步骤如下：1） APP固定配置一组CMS接口地址2） APP向CMS侧前置接口获取HTTPDNS 服务入口地址以及相关的配置信息Config3） APP根据Config确定是否使用HTTPDNS服务4） 若HTTP

3、DNS服务开启，则APP向云谷HTTPDNS 服务请求域名相关的业务IP1、IP2.5） APP直接使用获取到业务IP1、IP2地址，来请求业务。6） 若HTTPDNS服务关闭或HTTPDNS服务请求失败，则APP直接使用localDNS3.2 APP向CMS前置接口获取请求HTTP DNS 配置信息a)返回多个HTTPDNS服务入口地址(目前为云谷机房地址)和各类配置项e)请求格式接口见接口1图1:客户端向cms请求流程图3.3 APP向HTTP DNS 服务请求解析域名，并请求业务 a) 返回业务IP地址，结果为Json格式b) 包含参数有：ttl（全局）， ip , priority （

4、对应ip）c) ttl过期需要重新请求数据d) 一个url使用2个ip访问都timeout后,直接访问localDNSe) 按priority 由大到小选择IP，若各业务IP priority 相同，则随机选择f) 同一priority ip选完后,选更小的priority ip g) 若所有业务均请求失败，则走 localDNSh) HTTPDNS 返回数据接口见接口2i) 调用HTTPDNS服务成功与否，均需上报请求HTTPDNS结果数据，见接口3j) APP请求业务完成，上报请求业务后的结果数据，见接口5图2:客户端向HTTPDNS请求流程图图2:客户端获得HTTPDNS数据工作流程图3

5、.4 部署说明a) 部署域名如下：route.titan.imgo.tvb) APP 灰度升级c) 三层错误上报接口有升级， 见接口4四、 接口说明4.1 接口1请求返回/ "httpdns": "status": 0,/开关 "globalswitch”: 0,/是否应用域名下的所有接口 "interval": 300, /请求httpdns服务器的最短间隔时间(秒) "requesttimeout": 30,/ 请求HTTPDNS服务器超时时间(秒) "failurenum": 1

6、,/ HTTPDNS服务器下发的IP使用几次后失效/ HTTPDNS服务器url地址 "requesturls": "http:/host1/domain=xxx", "http:/host2/domain=xxx" ,/域名相应启用的接口映射表 "businesscgis": "domain": "surpport.hunantv",/域名 /域名下启用的接口 "api": "getSource", "getDetail&q

7、uot; , "domain": "getSource.hunantv", "api": "getSource", "getDetail" 4.2 接口2请求http:/【httpdnsservice】/dnsE.g.: 55:54420/dns返回请求返回的结果为json格式，其中device_ip为发送请求的设备ip，device_sp为isp的编号，dns则是返回的一组ip，每组ip都有ip地址，优先级(数字越大优先级越高)，ttl缓存时间(毫秒),time

8、out超时(毫秒)。"ttl": 600,"device_ip": "", "device_isp": "0", "domains": "dns": "ip": "37", "priority": 2 , "ip": "36", "priority": 0 , "

9、ip": "35", "priority": 0 , "ip": "38", "priority": 0 , "domain": "route1.titan.imgo.tv" , "dns": "ip": "37", "priority": 2 , "ip": "11

10、36", "priority": 0 , "domain": "" 部分ISP对应的编号如下，可测试使用，详细的编号之后会给出： '0': '默认', '1': '电信', '2': '联通', '3': '铁通', '4': '移动', '5': '教育网', '6': '广电网',

11、 '7': '其他',4.3 接口3描述内容接口协议HTTP GET接口域名平台参数p=(1:iphone|2:ipad|3:aphone|4:pcweb|5:ipadH5|6:M站|7:ott)版本v=用户标识(guid)u=解析故障f= (0:成功，-1-失败)访问接口ipi=布码版本cv=示例:4.4 接口4描述内容接口协议HTTP GET接口域名平台参数p=(1:iphone|2:ipad|3:aphone|4:pcweb|5:ipadH5|6:M站|7:ott)版本v=用户标识(guid)u=访问正常标记f= (0：成功，-1：失败)播放步骤s=(1:

12、访问CMS，2：访问调度器，3：访问cache节点)访问域名接口(hostname)h=访问接口的uril=是否切换码率a=(0:首次加载，1：切换码率。2：手动重试，3：自动切换)访问cms时的sourceIDsi=播放类型标记(直播，点播)t=(0：点播、1：直播、2：轮播、3：缓存播放、4：现场直播)错误码(码表)e=布码版本cv=返回值HTTP CodeHTTPDNS状态码hf=(0：未启用HTTPDNS、1：开启HTTPDNS，并成功解析、2：开启HTTPDNS，并使用localDNS、3：HTTPDNS服务不可达)HTTPDNS iphi=示例：4.5 接口5描述内容接口协议HTTP GET接口域名平台参