8d0c4d9da1
- it.com, uk.com 등 CentralNic 사설 ccSLD 목록 추가 - 미지원 ccSLD 조회 시 적절한 안내 메시지 반환 - README.md 문서 작성 (API 사용법, 지원 TLD, ccSLD 안내) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
# 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
|