Nhân Hòa Logo
Quay lại trang chủ

API Swagger Documentation

Tài liệu chi tiết về các endpoints API backend hỗ trợ thực thi của hệ thống Nhân Hòa Tools.

Base Server URL

http://localhost:3000
POST/api/tools/ping
Ping Host / IP Address

Kiểm tra độ trễ mạng và khả năng kết nối tới địa chỉ IP hoặc tên miền thông qua lệnh ping hệ thống.

Tham số truyền vào (Body JSON)
{
  "host": "google.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "Pinging google.com [172.217.24.46] with 32 bytes of data...\nReply from 172.217.24.46: bytes=32 time=5ms TTL=118"
}
POST/api/tools/port-scanner
Port Scanner Checker

Quét các cổng phổ biến (21, 22, 80, 443, 3306...) để xác định trạng thái mở hoặc đóng của cổng dịch vụ.

Tham số truyền vào (Body JSON)
{
  "host": "8.8.8.8"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "Kết quả quét cổng cho 8.8.8.8:\n\nCổng 22   : Đóng\nCổng 80   : Mở (Open)\nCổng 443  : Mở (Open)"
}
POST/api/tools/ip-geolocation
IP Geolocation Lookup

Truy vấn thông tin quốc gia, thành phố, tọa độ địa lý và nhà cung cấp ISP từ địa chỉ IP.

Tham số truyền vào (Body JSON)
{
  "host": "8.8.8.8"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": {
    "status": "success",
    "country": "United States",
    "city": "Ashburn",
    "isp": "Google LLC",
    "lat": 39.03,
    "lon": -77.5
  }
}
POST/api/tools/whois
Domain WHOIS Query

Truy vấn thông tin chi tiết về chủ sở hữu, ngày đăng ký, ngày hết hạn tên miền từ WHOIS servers.

Tham số truyền vào (Body JSON)
{
  "domain": "nhanhoa.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "Domain Name: nhanhoa.com\nRegistry Domain ID: 968032_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.tucows.com..."
}
POST/api/tools/dns-records
DNS Records Enumerator

Truy vấn tất cả bản ghi DNS phổ biến bao gồm A, AAAA, MX, TXT, NS, CNAME, SOA.

Tham số truyền vào (Body JSON)
{
  "domain": "nhanhoa.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": {
    "A": ["103.28.36.14"],
    "MX": [{ "exchange": "mail.nhanhoa.com", "priority": 10 }],
    "TXT": [["v=spf1 include:spf.nhanhoa.com ~all"]]
  }
}
POST/api/tools/ssl-checker
SSL Certificate Checker

Khởi tạo bắt tay TLS bảo mật để giải mã các thông số hiệu lực chứng chỉ SSL, đơn vị phát hành và thời gian hết hạn.

Tham số truyền vào (Body JSON)
{
  "domain": "google.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": {
    "subject": { "CN": "google.com" },
    "issuer": { "O": "Google Trust Services" },
    "valid_from": "May 10 12:00:00 2026 GMT",
    "valid_to": "Aug 02 12:00:00 2026 GMT"
  }
}
POST/api/tools/blacklist-check
IP/Domain Spam Check

Xác định địa chỉ IP hoặc tên miền có nằm trong danh sách đen chặn spam của Spamhaus, SORBS hay không.

Tham số truyền vào (Body JSON)
{
  "target": "1.1.1.1"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "Báo cáo Blacklist cho IP 1.1.1.1:\n\nzen.spamhaus.org          : Sạch (Clean)\ndnsbl.sorbs.net           : Sạch (Clean)"
}
POST/api/tools/smtp-test
SMTP Handshake Connection

Mô phỏng kết nối cổng 25 tới máy chủ mail nhận và thực hiện bắt tay SMTP (HELO -> MAIL FROM -> RCPT TO -> QUIT).

Tham số truyền vào (Body JSON)
{
  "target": "gmail.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "Đang kết nối tới gmail-smtp-in.l.google.com...\nS: 220 mx.google.com ESMTP\nC: HELO nhanhoa.com.vn\nS: 250 mx.google.com Hello\nSMTP Handshake hoàn tất!"
}
POST/api/tools/webpage-to-markdown
Webpage to Markdown Scraper

Crawl nội dung trang web, tự động xóa script/css rác, trích xuất văn bản thuần và convert thành định dạng Markdown.

Tham số truyền vào (Body JSON)
{
  "url": "https://nhanhoa.com"
}
Phản hồi (Response JSON)
{
  "success": true,
  "data": "# Nhân Hòa - Nhà đăng ký tên miền quốc gia\n\nDịch vụ lưu trữ Cloud VPS, Dedicated Server chuyên nghiệp..."
}