Tài liệu Hướng dẫn API

WhatIsUIP cung cấp các endpoint API đơn giản, hiệu năng cao để lấy địa chỉ IP công cộng và thông tin kết nối dưới nhiều định dạng khác nhau. Không cần xác thực.

Địa chỉ IP dạng Văn bản thuần (Plain Text)

GET/api/ip(text/plain)

Trả về địa chỉ IP công cộng dưới dạng văn bản thuần. Thích hợp cho shell script, CLI tool và tự động hóa đơn giản.

Ví dụ lệnh Shell

curl https://whatisuip.com/api/ip

Phản hồi mẫu

113.178.52.210

Địa chỉ IP & Geo dạng JSON đơn giản

GET/api/ip.json(application/json)

Trả về địa chỉ IP công cộng, mã quốc gia và tên thành phố dưới dạng JSON.

Ví dụ lệnh Shell

curl https://whatisuip.com/api/ip.json

Phản hồi mẫu

{
  "ip": "113.178.52.210",
  "country": "VN",
  "city": "Hanoi"
}

Thông tin Client chi tiết

GET/api/info(application/json)

Trả về toàn bộ thông tin chi tiết về client dưới dạng JSON, bao gồm vị trí địa lý, ISP/ASN, kiểm tra bảo mật VPN/Tor, phân tích User Agent và các HTTP header gốc.

Ví dụ lệnh Shell

curl https://whatisuip.com/api/info

Phản hồi mẫu

{
  "ip": "113.178.52.210",
  "geo": {
    "country": "VN",
    "countryName": "Vietnam",
    "region": "Hanoi",
    "city": "Hanoi",
    "timezone": "Asia/Bangkok",
    "latitude": 21.0245,
    "longitude": 105.8412,
    "asn": "AS45899",
    "asnOrg": "VNPT Corp"
  },
  "vpn": {
    "isTor": false,
    "isDatacenter": false,
    "flags": []
  },
  "ua": {
    "browser": {
      "name": "Chrome",
      "version": "149.0.0.0"
    },
    "os": {
      "name": "Windows",
      "version": "10"
    },
    "device": {
      "type": "desktop"
    }
  },
  "headers": {
    "host": "whatisuip.com",
    "user-agent": "Mozilla/5.0 ...",
    "accept": "*/*"
  }
}