Công cụ Network

Công cụ Network: Tra cứu, Kiểm tra

Tổng quan

Công cụ Network: Tra cứu, Kiểm tra

  • Tra cứu: IP Geolocation
  • Kiểm tra: Kiểm tra IP Blacklist, Ping host, Quét port
  • Authentication: API key Bearer token qua header Authorization: Bearer YOUR_API_KEY

Base URL: https://developers-dev.inet.vn/api/gateway/v1

Response wrapper: Tất cả response được wrap trong { success, data, meta }. Response schema bên dưới mô tả nội dung field data. Xem chi tiết tại Response Format.


Tra cứu

IP Geolocation

POST /network/ip-location

Tra cứu vị trí địa lý của địa chỉ IP. Trả về quốc gia, timezone, tọa độ, và thông tin user agent.

Request Body

TrườngKiểuBắt buộcMô tả
ipstringĐịa chỉ IPv4 cần tra cứu (vd: 1.2.3.4)
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip":"1.2.3.4"}' \
  "https://developers-dev.inet.vn/api/gateway/v1/network/ip-location"

Response

JSON
{
  "data": {
    "geo": {
      "ip": "example_ip",
      "ll": [
        "example"
      ],
      "city": "example_city",
      "country": "VN",
      "timezone": "example_timezone"
    },
    "ipClient": "example_ipClient",
    "ipRequest": "example_ipRequest"
  },
  "status": "example_status"
}
TrườngKiểuMô tả
dataobject
data.geoobject
data.ipClientstringIP của client gọi API
data.ipRequeststringIP đang tra cứu
statusstring

Kiểm tra

Kiểm tra IP Blacklist

GET /network/rbl-check

Kiểm tra IP có nằm trong danh sách đen (RBL/DNSBL) hay không. Quét qua nhiều blacklist providers.

Path parameter: /rblcheck/{ip} Ví dụ: /rblcheck/1.2.3.4

Tham sốVị tríKiểuBắt buộcMô tả
ippathstringĐịa chỉ IPv4 cần kiểm tra
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/network/rbl-check"

Ping host

GET /network/ping

Ping một host để kiểm tra kết nối và độ trễ. Trả về thời gian phản hồi, packet loss, min/max/avg.

Path parameter: thêm hostname vào sau URL. Ví dụ: /ping/inet.vn

Tham sốVị tríKiểuBắt buộcMô tả
hostpathstringHostname hoặc IP cần ping
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/network/ping"

Quét port

GET /network/port-scan

Kiểm tra port đang mở hay đóng trên host.

Path parameters: /portscanner/{host}/{port} Ví dụ: /portscanner/inet.vn/443

Tham sốVị tríKiểuBắt buộcMô tả
hostpathstringHostname hoặc IP
portpathintegerSố port cần kiểm tra (vd: 80, 443, 3306)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/network/port-scan"

Response

JSON
{
  "host": "example_host",
  "ports": {
    "open": [
      "example"
    ],
    "closed": [
      "example"
    ]
  }
}
TrườngKiểuMô tả
hoststring
portsobject
ports.openarray
ports.closedarray