เอกสารสำหรับนักพัฒนาและ API

เอ็นด์พอยต์ (Endpoints)

GET /api/my-ip

ส่งคืนข้อมูลตำแหน่งทางภูมิศาสตร์และเครือข่ายสำหรับ IP สาธารณะของผู้เรียก ตามที่เซิร์ฟเวอร์มองเห็น

curl https://ipcheck.mubarokah.com/api/my-ip

GET /api/lookup?q=<ip|domain>

ค้นหา IPv4, IPv6 หรือโดเมนเปล่าใดๆ รูปแบบโปรโตคอล (http/https) และเส้นทางจะถูกปฏิเสธ

curl "https://ipcheck.mubarokah.com/api/lookup?q=8.8.8.8"

POST /api/bulk

การค้นหาแบบกลุ่ม (สูงสุด 50 รายการต่อคำขอ) การประมวลผลพร้อมกันจะถูกจำกัดที่ฝั่งเซิร์ฟเวอร์

curl -X POST -H 'content-type: application/json' \
  -d '{"queries":["8.8.8.8","1.1.1.1","example.com"]}' \
  https://ipcheck.mubarokah.com/api/bulk

รูปแบบการตอบกลับ

{
  "ok": true,
  "query": "8.8.8.8",
  "ip": "8.8.8.8",
  "ipVersion": "IPv4",
  "location": {
    "continent": "North America",
    "country": "United States",
    "countryCode": "US",
    "regionName": "Virginia",
    "city": "Ashburn",
    "zip": "20149",
    "lat": 39.0438,
    "lon": -77.4874,
    "timezone": "America/New_York",
    "utcOffsetSeconds": -14400,
    "currency": "USD"
  },
  "network": {
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "as": "AS15169 Google LLC",
    "asname": "GOOGLE",
    "reverse": "dns.google"
  },
  "flags": { "mobile": false, "proxy": false, "hosting": true }
}

ข้อผิดพลาด

• invalid_query — ข้อมูลที่ป้อนไม่ใช่ IP หรือโดเมนที่ถูกต้อง
• rate_limited — ถึงขีดจำกัดอัตราของผู้ให้บริการต้นน้ำแล้ว
• provider_unreachable — เซิร์ฟเวอร์ต้นน้ำออฟไลน์

การจำกัดอัตราและแคช

ผลลัพธ์จะถูกเก็บไว้ในแคชฝั่งเซิร์ฟเวอร์เป็นเวลา 10 นาทีต่อการค้นหา ระดับสาธารณะฟรีของผู้ให้บริการต้นน้ำจะถูกจำกัดอัตราการใช้งานและมีไว้สำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์ สำหรับทราฟฟิกการใช้งานจริง เราขอแนะนำให้ตั้งค่าผู้ให้บริการเชิงพาณิชย์ผ่านตัวแปรสภาพแวดล้อมที่ระบุด้านล่าง

เลเยอร์ผู้ให้บริการ

ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้บนเซิร์ฟเวอร์ ข้อมูลลับจะไม่ถูกเปิดเผยต่อเบราว์เซอร์

IP_PROVIDER=ip-api            # or ip-api-pro
IP_API_KEY=...                # required for pro
IP_API_BASE=http://ip-api.com

หมายเหตุ

• การระบุตำแหน่งทางภูมิศาสตร์ของ IP เป็นเพียงการประมาณการ โดยมีความแม่นยำสูงสุดในระดับเมืองหรือระดับมหานครเท่านั้น
• ช่วง IP ส่วนตัวและที่ถูกสำรองไว้ไม่สามารถระบุตำแหน่งทางภูมิศาสตร์ได้
• API จะไม่บันทึกเนื้อหาการค้นหานอกเหนือจากที่จำเป็นสำหรับการทำแคชเท่านั้น