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ường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
ip | string | Có | Đị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
{
"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ường | Kiểu | Mô tả |
|---|---|---|
data | object | |
data.geo | object | |
data.ipClient | string | IP của client gọi API |
data.ipRequest | string | IP đang tra cứu |
status | string |
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ểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
ip | path | string | Có | Đị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ểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
host | path | string | Có | Hostname 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ểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
host | path | string | Có | Hostname hoặc IP |
port | path | integer | Có | Số 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
{
"host": "example_host",
"ports": {
"open": [
"example"
],
"closed": [
"example"
]
}
}
| Trường | Kiểu | Mô tả |
|---|---|---|
host | string | |
ports | object | |
ports.open | array | |
ports.closed | array |