APIGeoIP.RU

Что входит в текущую версию API

Endpoint

Параметры запроса

Правила фильтрации полей

Примеры точечной фильтрации fields + crypto

1. Только страна + risk score

curl -G "https://apigeoip.ru/api/" \
  --data-urlencode "ip=8.8.8.8" \
  --data-urlencode "user_id=user_001" \
  --data-urlencode "fields=geo.country,antifraud.risk_score" \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Country enrichment + только BTC/ETH

curl -G "https://apigeoip.ru/api/" \
  --data-urlencode "ip=8.8.8.8" \
  --data-urlencode "user_id=user_001" \
  --data-urlencode "fields=geo.country,geo.country_enrichment.rates" \
  --data-urlencode "crypto=BTC,ETH" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Узкий antifraud-профиль

curl -G "https://apigeoip.ru/api/" \
  --data-urlencode "ip=8.8.8.8" \
  --data-urlencode "user_id=user_001" \
  --data-urlencode "fields=antifraud.risk_score,antifraud.confidence,antifraud.signals" \
  -H "Authorization: Bearer YOUR_API_KEY"

Если часть запрошенных путей недоступна по тарифу, API вернет доступные поля и блок access.missing_fields.

Авторизация (Bearer)

Authorization: Bearer YOUR_API_KEY

Передавайте API-ключ только в заголовке Authorization. Ключ в query string не поддерживается.

Как выбирать user_id

Пример cookie-based user_id

function getOrCreateUserId() {
  const key = 'gid_uid';
  const found = document.cookie.split('; ').find(v => v.startsWith(key + '='));
  if (found) return decodeURIComponent(found.split('=')[1]);

  const uid = 'anon_' + crypto.randomUUID().replace(/-/g, '').slice(0, 16);
  document.cookie = `${key}=${encodeURIComponent(uid)}; Max-Age=31536000; Path=/; SameSite=Lax`;
  return uid;
}

Успешный ответ (тариф geo)

{
  "status": "ok",
  "error_code": 0,
  "http_status": 200,
  "ip": "8.8.8.8",
  "ua": "Mozilla/5.0 ...",
  "user_id": "usr_15293",
  "subscription_type": "geo",
  "geo": {
    "city": {"name": "Mountain View"},
    "country": {"iso_code": "US", "name": "United States"},
    "location": {"latitude": 37.4056, "longitude": -122.0775},
    "timezone": "America/Los_Angeles",
    "country_enrichment": {
      "tld": ".us",
      "currency": {"code": "USD"},
      "rates": {"currency_code": "USD", "units_per_usd": 1}
    }
  }
}

Успешный ответ (тариф antifraud)

{
  "status": "ok",
  "error_code": 0,
  "http_status": 200,
  "subscription_type": "antifraud",
  "geo": {...},
  "asn": {"asn": 15169, "org": "Google LLC"},
  "ptr": "dns.google",
  "antifraud": {
    "risk_score": 42,
    "proxy_suspected": false,
    "confidence": 0.7,
    "signals": ["ASN:heuristic"],
    "advanced_insights": {
      "impossible_travel": {"is_detected": false},
      "business_hours_mismatch": {"is_mismatch": false},
      "smart_action_hint": "allow"
    }
  }
}

Полный каталог полей ответа (paths)

Формат ответа с ошибкой

{
  "status": "error",
  "error_code": 1005,
  "http_status": 401,
  "message": "Invalid API key"
}

Числовые коды ошибок

Примеры

cURL

curl -G "https://apigeoip.ru/api/" \
  --data-urlencode "ip=8.8.8.8" \
  --data-urlencode "user_id=anon_7f3a2c9a1e44b2d0" \
  --data-urlencode "fields=geo.country,geo.country_enrichment.tld,antifraud.risk_score" \
  --data-urlencode "crypto=BTC,ETH" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript (fetch)

const url = new URL("https://apigeoip.ru/api/");
url.searchParams.set("ip", "8.8.8.8");
url.searchParams.set("user_id", "anon_7f3a2c9a1e44b2d0");
url.searchParams.set("fields", "geo.country,geo.country_enrichment.tld,antifraud.risk_score");
url.searchParams.set("crypto", "BTC,ETH");

const res = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
});
const data = await res.json();
console.log(data.antifraud?.risk_score, data.antifraud?.advanced_insights?.smart_action_hint);

PHP (cURL)

$url = "https://apigeoip.ru/api/?ip=8.8.8.8&user_id=anon_7f3a2c9a1e44b2d0&fields=geo.country,geo.country_enrichment.tld,antifraud.risk_score&crypto=BTC,ETH";
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer YOUR_API_KEY"],
]);
$response = curl_exec($ch);
curl_close($ch);

$payload = json_decode($response, true);
echo $payload["antifraud"]["risk_score"] ?? "n/a";

Примечания по лимитам и надежности