feat: 사설 ccSLD 미지원 처리 및 README 추가
- it.com, uk.com 등 CentralNic 사설 ccSLD 목록 추가 - 미지원 ccSLD 조회 시 적절한 안내 메시지 반환 - README.md 문서 작성 (API 사용법, 지원 TLD, ccSLD 안내) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
99
README.md
Normal file
99
README.md
Normal file
@@ -0,0 +1,99 @@
|
||||
# WHOIS API
|
||||
|
||||
Vercel Edge Function 기반 WHOIS 조회 API 서버
|
||||
|
||||
## 기능
|
||||
|
||||
- 다양한 TLD(gTLD, ccTLD) 지원
|
||||
- 자동 WHOIS 서버 감지
|
||||
- 도메인 정보 파싱 (등록자, 만료일, 네임서버 등)
|
||||
- 사설 ccSLD 감지 및 안내
|
||||
|
||||
## API 사용법
|
||||
|
||||
### 엔드포인트
|
||||
|
||||
```
|
||||
GET /api/whois/{domain}
|
||||
```
|
||||
|
||||
### 요청 예시
|
||||
|
||||
```bash
|
||||
curl https://your-domain.vercel.app/api/whois/example.com
|
||||
```
|
||||
|
||||
### 응답 예시
|
||||
|
||||
```json
|
||||
{
|
||||
"domain": "example.com",
|
||||
"whois_server": "whois.verisign-grs.com",
|
||||
"raw": "...",
|
||||
"parsed": {
|
||||
"registrar": "Example Registrar",
|
||||
"creation_date": "1995-08-14",
|
||||
"expiration_date": "2025-08-13",
|
||||
"name_servers": ["ns1.example.com", "ns2.example.com"]
|
||||
},
|
||||
"query_time_ms": 234
|
||||
}
|
||||
```
|
||||
|
||||
## 지원 TLD
|
||||
|
||||
### Generic TLDs
|
||||
com, net, org, info, biz, io, co, app, dev, xyz, online, site, tech, store, blog 등
|
||||
|
||||
### Country Code TLDs
|
||||
kr, jp, cn, uk, de, fr, ru, au, br, in, it, es, nl, se, no, fi, dk, pl, cz, at, ch, be, ca, mx, ar, cl, nz 등
|
||||
|
||||
## 사설 ccSLD 처리
|
||||
|
||||
다음 사설 ccSLD는 공개 WHOIS를 제공하지 않아 별도 안내를 반환합니다:
|
||||
|
||||
| ccSLD | 운영자 | 비고 |
|
||||
|-------|--------|------|
|
||||
| it.com | it.com Domains Ltd | 런던 소재 사설 레지스트리 |
|
||||
| uk.com | CentralNic | WHOIS 미제공 |
|
||||
| us.com | CentralNic | WHOIS 미제공 |
|
||||
| eu.com | CentralNic | WHOIS 미제공 |
|
||||
| de.com | CentralNic | WHOIS 미제공 |
|
||||
| br.com | CentralNic | WHOIS 미제공 |
|
||||
| cn.com | CentralNic | WHOIS 미제공 |
|
||||
| jpn.com | CentralNic | WHOIS 미제공 |
|
||||
| kr.com | CentralNic | WHOIS 미제공 |
|
||||
| ru.com | CentralNic | WHOIS 미제공 |
|
||||
| za.com | CentralNic | WHOIS 미제공 |
|
||||
|
||||
### 사설 ccSLD 응답 예시
|
||||
|
||||
```json
|
||||
{
|
||||
"domain": "example.it.com",
|
||||
"whois_supported": false,
|
||||
"ccSLD": "it.com",
|
||||
"message": "it.com is a private ccSLD that does not provide public WHOIS data",
|
||||
"message_ko": "it.com은(는) 공개 WHOIS를 제공하지 않는 사설 ccSLD입니다",
|
||||
"suggestion": "Use registrar account API or contact the registry directly",
|
||||
"suggestion_ko": "등록기관 계정 API를 사용하거나 레지스트리에 직접 문의하세요",
|
||||
"query_time_ms": 1
|
||||
}
|
||||
```
|
||||
|
||||
## 로컬 개발
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## 배포
|
||||
|
||||
```bash
|
||||
npm run deploy
|
||||
```
|
||||
|
||||
## 라이선스
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user