# CheckDomain

**Repository Path**: noisky/CheckDomain

## Basic Information

- **Project Name**: CheckDomain
- **Description**: CheckDomain 是一个用来检查域名是否注册的 Api，基于 Spring Boot 构建
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2019-12-22
- **Last Updated**: 2023-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

CheckDomain
========
![license]
![GitHub repo size]


由于我看中了一个域名处于即将删除的状态，于是就诞生了 CheckDomain 来帮我监控这个域名。

CheckDomain 是一个用来检查域名是否能注册的 Api，基于 Spring Boot 构建，使用了阿里云域名查询 Api；

可实现对域名状态查询，可注册监控，whois 信息查询等，并在域名可以注册的时候发送邮件通知。

现在新增了前端页面，可以直接在页面上进行 whois 信息的查询了

如果需要前后端分离部署，直接修改 index.html 中 118 行的 baseUrl 为相应的后端地址即可

Demo：https://whois.ffis.me

![whois查询页面展示](https://img.ffis.me/images/2020/02/27/whoisInfo.png)

![邮件通知注册演示](https://img.ffis.me/images/2019/12/05/checkdomain.png)


### 接口调用：

1、查看域名状态：

- 请求方式：`GET请求`
    
    - 请求地址：`/domain/{name}`
    
    - 参数说明：
        
        - `{name}`： 查询的域名

2、查看域名状态并在可注册时发送邮件通知：

1）请求方式：`GET请求`

- 请求地址：`/domain/{name}/{email}/{querykey}`

- 参数说明：
 
    - `{name}`： 查询的域名
    
    - `{email}`： 接受通知的邮箱地址
   
    - `querykey`： 查询密码，在 yml 配置文件中设置
        
2）请求方式：`POST请求`

- 请求地址：`/domain/{name}`

- 参数说明：
 
    - `{name}`： 查询的域名
    
    - POST提交的表单：
    
        - `email`： 接受通知的邮箱地址
        
        - `querykey`： 查询密码，在 yml 配置文件中设置

> 可以使用第三方监控（如阿里云监控）来请求 Api 来达到监控域名注册状态

3、查询域名whois信息：

- 请求方式：`GET请求`
    
    - 请求地址：`/whois/{domain}`
    
    - 参数说明：
        
        - `{domain}`： 查询的域名
        
        - 暂时只支持 .com/.net/.edu/.org/.me/.cn 域名的查询


### 已完成功能：
- [x] 检查域名是否能注册
- [x] 监控域名状态，如果可以注册，发送邮件通知
- [x] 使用 Freemarker 实现邮件模板的静态化
- [x] 使用 Logback 记录系统运行日志
- [x] 实现域名的 whois 信息查询（参考了 tammypi 的 whoisutil 工具类）
- [x] 编写前端页面，方便查询；已完成编写，现在可以直接在页面上查询 whois 信息了
- [ ] 限制接口的调用频率
- [ ] 统计并记录接口的调用次数，调用耗时等信息


### Thanks：
tammypi：[whoisutil][whoisutil]

[license]:https://img.shields.io/github/license/noisky/CheckDomain?color=blue
[GitHub repo size]:https://img.shields.io/github/repo-size/noisky/CheckDomain?logo=git
[whoisutil]:https://github.com/tammypi/whoisutil