خواندن پاسخ

پاسخ تارکاو اطلاعات یک شبکه را توصیف می‌کند. بعضی اطلاعات، مانند اپراتور، شهر و استان، فقط در صورت موجود بودن داده برگردانده می‌شوند.

یک پاسخ نمونه

این نمونه فقط برای نشان دادن ساختار پاسخ است؛ مقادیر آن دادهٔ زنده نیستند و پاسخ واقعی ممکن است فیلدهای کمتری داشته باشد.

{
  "found": true,
  "ip": "2.144.0.1",
  "network": "2.144.0.0/16",
  "country": {
    "code": "IR",
    "nameFa": "ایران",
    "nameEn": "Iran"
  },
  "asn": {
    "number": 64500,
    "name": "Example Network"
  },
  "provider": {
    "key": "example",
    "nameFa": "اپراتور نمونه",
    "type": "mobile"
  },
  "province": "استان نمونه",
  "city": "شهر نمونه",
  "hosting": false,
  "confidence": {
    "country": 0.99,
    "asn": 0.95,
    "provider": 0.9,
    "networkType": 0.9
  }
}

معنی فیلدها

وقتی اطلاعاتی پیدا نمی‌شود

اگر رکوردی موجود نباشد، پاسخ موفق با found: false دریافت می‌کنید. این نتیجه خطای سرویس نیست و همچنان یک جست‌وجو محسوب می‌شود.

{
  "found": false,
  "ip": "2.144.0.1"
}

حتی در پاسخ با found: true هم ممکن است فیلدهای اختیاری حذف شده باشند. برنامه باید نبودن آن‌ها را بپذیرد؛ مثلاً به جای نام اپراتور، «نامشخص» نمایش دهد.

نوع شبکه چه معنی دارد؟

نوع شبکه در provider.type قرار دارد. اگر provider در پاسخ نباشد، نوع شبکه را نامشخص در نظر بگیرید.