基于DNSPod API进行开发

yaolinnan

浏览: 58603 次
性别:
来自: 长沙

最近访客更多访客>>

flyingbigsandy

yokoboy

kjyzy

zhutao05

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (50)

社区版块

存档分类

DNSPod是目前国内最大的第三方免费DNS解析服务商、中国第三大域名托管商。它除了实时生效、不限制用户添加的域名和记录数量、提供URL转发、搜索引擎优化、域名共享管理、域名锁定、IPv6的支持、动态域名解析、API接口、批量修改管理等先进功能外，还拥有：云DNS、DNSPod DNS Protector（DNSPod 自主研发的DNS 防护软件）、宕机监控、7*24小时技术支持。并且所有功能都是免费提供。

API文档地址：https://www.dnspod.cn/client/user_api_doc.pdf

API说明：

1、只支持POST方式请求数据

2、请求的地址为 https://dnsapi.cn/ 开头的地址，基于 SSL 安全传输。

3、首先需要注册DNSpod账号，所有请求都要通过你的账号才能完成。

4、公共参数（即所有接口都需要这些参数）如下：

• login_email 用户帐号，必选

• login_password 用户密码，必选

• format {json,xml} 返回的数据格式，可选，默认为 xml，建议用 json

• lang {en,cn} 返回的错误语言，可选，默认为 en，建议用 cn

• error_on_empty {yes,no} 没有数据时是否返回错误，可选，默认为 yes，建议用 no

• user_id 用户的 ID，可选，仅代理接口需要，用户接口不需要提交此参数

5、共同返回结果（即所有接口都可能返回的结果）：

• -1 登陆失败

• -2 API 使用超出限制

• -3 不是合法代理 (仅用于代理接口)

• -4 不在代理名下 (仅用于代理接口)

• -7 无权使用此接口

• -8 登录失败次数过多，账号被暂时封禁

• -99 此功能暂停开放，请稍候重试

• 1 操作成功

• 2 只允许 POST 方法

• 3 未知错误

• 6 用户 ID 错误 (仅用于代理接口)

• 7 用户不在您名下 (仅用于代理接口)

代码实例：

功能说明：完成域名添加和查询，在指定域名下添加记录

1、添加实体类：Domain、Record

//域名
public class Domain {

	private int id;//域名ID
	
	private String name;//域名名称
	
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	
	
}

//记录
public class Record {

	private int id;//记录ID
	
	private int domainId;//域名ID
	
	private String prefix;//域名前缀
	
	private RecordType type;//记录类型
	
	private String value;//记录值
	
	private int time;//缓存的生存时间(单位为秒)

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public int getDomainId() {
		return domainId;
	}

	public void setDomainId(int domainId) {
		this.domainId = domainId;
	}

	public String getPrefix() {
		return prefix;
	}

	public void setPrefix(String prefix) {
		this.prefix = prefix;
	}

	public RecordType getType() {
		return type;
	}

	public void setType(RecordType type) {
		this.type = type;
	}

	public String getValue() {
		return value;
	}

	public void setValue(String value) {
		this.value = value;
	}

	public int getTime() {
		return time;
	}

	public void setTime(int time) {
		this.time = time;
	}
	
}

//几种常用的记录类型（参照DNSpod官网）
public enum RecordType {

	A,//如果需要将域名指向一个IP地址，就需要添加A记录
	CNAME,//如果需要将域名指向另一个域名，再由另一个域名提供ip地址，就需要添加CNAME记录
	MX,//如果需要设置邮箱，让邮箱能收到邮件，就需要添加MX记录
	TXT,//在这里可以填写任何东西，长度限制255。绝大多数的TXT记录是用来做SPF记录（反垃圾邮件）
	显性URL,//从一个地址301重定向到另一个地址的时候，就需要添加显性URL记录
	隐性URL;//类似于显性URL，区别在于隐性URL不会改变地址栏中的域名
}

2、编写测试类

public class Test {
	
	private final static String USER_NAME="xxx";//DNSpod账号
	
	private final static String PASSWORD="xxx";//密码

	public static void main(String[] args) {
		try {
			Domain domain=new Domain();
			domain.setName("yaolinnan.com");
			addDomain(domain);
			List<Domain> domains=getDomainList();
			System.out.println(domains);
			Record record=new Record();
			record.setDomainId(domains.get(0).getId());//为第一个域名添加记录
			record.setPrefix("test");
			record.setValue("www.baidu.com");
			record.setTime(600);
			record.setType(RecordType.CNAME);
			addRecord(record);
		} catch (Exception e) {
			e.printStackTrace();
		} 
		//getType("3162381","D_Free");
	}
	
	//根据请求的地址和参数获得返回的流
	private static InputStream getUrlInput(String httpsUrl,String datas){
		URL url;
		try {
			url = new URL(httpsUrl);
			HttpsURLConnection connection=(HttpsURLConnection) url.openConnection();
			System.out.println("submit params:"+datas);
			boolean doOut=false;
			byte[] bytes=datas.getBytes("utf-8");
			if(bytes!=null&&bytes.length>0)
				doOut=true;
			connection.setDoOutput(doOut);
			if(doOut){
				OutputStream out=connection.getOutputStream();
				out.write(bytes);//以POST方式发送参数
			}
			InputStream input=connection.getInputStream();
			return input;//得到接口的返回结果
		} catch (Exception e) {
			e.printStackTrace();
		}
		return null;
	}
	
	//查询域名列表
	private static List<Domain> getDomainList() throws JDOMException, IOException{
			String datas="login_email="+USER_NAME+"&"+"login_password="+PASSWORD;
			SAXBuilder sb=new SAXBuilder();
			Document doc=sb.build(getUrlInput("https://dnsapi.cn/Domain.List",datas));
			Element element=doc.getRootElement();
			Element status=element.getChild("status");
			String code=status.getChildText("code");
			System.out.println("return message:"+status.getChildText("message"));
			if("1".equals(code)){//操作成功之后解析XML文档，获取需要的内容（参照API文档对应接口的返回参考）
				List<Domain> domains=new ArrayList<Domain>();
				Element domain=element.getChild("domains");
				if(domain!=null){
					List<Element> list=domain.getChildren("item");
					if(list!=null&&list.size()>0){
						for(int i=0;i<list.size();i++){
							Element e=list.get(i);
							String id=e.getChildText("id");
							String name=e.getChildText("name");
							Domain d=new Domain();
							d.setId(Integer.parseInt(id));
							d.setName(name);
							domains.add(d);
						}
					}
				}
				return domains;
			}
			return null;
	}
	
	//添加一个域名
	private static Domain addDomain(Domain domain) throws JDOMException, IOException{
		String datas="login_email="+USER_NAME+"&"+"login_password="+PASSWORD
				+"&"+"domain="+domain.getName();
		InputStream input=getUrlInput("https://dnsapi.cn/Domain.Create",datas);
		SAXBuilder sb=new SAXBuilder();
		Document doc=sb.build(input);
		Element element=doc.getRootElement();
		Element status=element.getChild("status");
		String code=status.getChildText("code");
		System.out.println("return message:"+status.getChildText("message"));
		if("1".equals(code)){
			Element detail=element.getChild("domain");
			if(detail!=null){
				String id=detail.getChildText("id");
				String punycode=detail.getChildText("punycode");
				Domain d=new Domain();
				d.setId(Integer.parseInt(id));
				d.setName(punycode);
				return d;
			}
		}
		return null;
	}
	
	
	//添加一条记录
	private static Record addRecord(Record record) throws JDOMException, IOException{
		String datas="login_email="+USER_NAME+"&"+"login_password="+PASSWORD
				+"&"+"domain_id="+record.getDomainId()+"&"+"sub_domain="+record.getPrefix()+"&"+"record_type="
				+record.getType()+"&"+"record_line=默认"+"&"+"value="+record.getValue()+"&"+"ttl="+record.getTime();
		
		InputStream input=getUrlInput("https://dnsapi.cn/Record.Create",datas);
		SAXBuilder sb=new SAXBuilder();
		Document doc=sb.build(input);
		Element element=doc.getRootElement();
		Element status=element.getChild("status");
		String code=status.getChildText("code");
		System.out.println("return message:"+status.getChildText("message"));
		if("1".equals(code)){
			Element detail=element.getChild("record");
			if(detail!=null){
				String id=detail.getChildText("id");
				String name=detail.getChildText("name");
				Record r=new Record();
				r.setId(Integer.parseInt(id));
				r.setPrefix(name);
				return r;
			}
		}
		return null;
	}
}

说明：对于DNSPod上的所有功能基本上都能在API文档中找到对应的接口，例如监控、记录的管理等等，可以参照上面的例子完成对应功能的实现。对于接口返回的结果分为XML和json两种数据类型，默认为XML，可以选择一种类型来进行数据的解析。

精彩科技工作室

分享到：