Обработка ошибок

{
  "errors": [
    {
      "detail": "The max age in days must be between 1 and 365.",
      "status": 422,
      "source": { "parameter": "maxAgeInDays" }
    }
  ]
}

# 401 — без ключа
curl -i -G https://api.abuseipdb.ru/api/v2/check \
  --data-urlencode "ipAddress=8.8.8.8" \
  -H "Accept: application/json"

HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8

{
  "errors": [
    {
      "detail": "Authentication failed. You have not provided a valid API key.",
      "status": 401
    }
  ]
}

# 401 — неверный ключ
curl -i -G https://api.abuseipdb.ru/api/v2/check \
  --data-urlencode "ipAddress=8.8.8.8" \
  -H "Key: definitely-not-a-valid-key" \
  -H "Accept: application/json"

{
  "errors": [
    {
      "detail": "Authentication failed. The API key you provided is invalid, expired or revoked.",
      "status": 401
    }
  ]
}

# 422 — невалидный maxAgeInDays
curl -i -G https://api.abuseipdb.ru/api/v2/check \
  --data-urlencode "ipAddress=8.8.8.8" \
  -d maxAgeInDays=0 \
  -H "Key: $API_KEY" \
  -H "Accept: application/json"

{
  "errors": [
    {
      "detail": "The max age in days must be between 1 and 365.",
      "status": 422,
      "source": { "parameter": "maxAgeInDays" }
    }
  ]
}

# 422 — невалидный адрес
curl -i -G https://api.abuseipdb.ru/api/v2/check \
  --data-urlencode "ipAddress=not-an-ip" \
  -H "Key: $API_KEY" \
  -H "Accept: application/json"

{
  "errors": [
    {
      "detail": "The ip address must be a valid IPv4 or IPv6 address.",
      "status": 422,
      "source": { "parameter": "ipAddress" }
    }
  ]
}

# 429 — дневная квота
curl -i -G https://api.abuseipdb.ru/api/v2/check \
  --data-urlencode "ipAddress=8.8.8.8" \
  -H "Key: $API_KEY" \
  -H "Accept: application/json"

HTTP/1.1 429 Too Many Requests
Retry-After: 29241
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1545973200

{
  "errors": [
    {
      "detail": "Daily rate limit of 1000 requests exceeded for this endpoint. See headers for additional details.",
      "status": 429
    }
  ]
}

# 429 — повторная жалоба за 15 минут (нужен любой ключ)
curl -i https://api.abuseipdb.ru/api/v2/report \
  --data-urlencode "ip=89.205.125.160" \
  -d categories=18 \
  --data-urlencode "comment=test duplicate" \
  -H "Key: $API_KEY" \
  -H "Accept: application/json"

{
  "errors": [
    {
      "detail": "You can only report the same IP address once in 15 minutes.",
      "status": 429,
      "source": { "parameter": "ip" }
    }
  ]
}

# 403 — clear-address обычным ключом
curl -i -X DELETE "https://api.abuseipdb.ru/api/v2/clear-address?ipAddress=89.205.125.160" \
  -H "Key: $API_KEY" \
  -H "Accept: application/json"

{
  "errors": [
    {
      "detail": "This endpoint (clear-address) requires an active subscription.",
      "status": 403
    }
  ]
}

import time
import requests

API_KEY = "YOUR_OWN_API_KEY"
BASE = "https://api.abuseipdb.ru/api/v2"

def api_get(path: str, params: dict) -> dict:
    for attempt in range(1, 4):
        response = requests.get(
            f"{BASE}/{path}",
            params=params,
            headers={"Key": API_KEY, "Accept": "application/json"},
            timeout=15,
        )
        if response.status_code == 200:
            return response.json()["data"]

        # 1) сначала код
        if response.status_code == 401:
            raise RuntimeError("ключ не принят: " + response.text)
        if response.status_code == 403:
            raise RuntimeError("нет прав/тарифа: " + response.text)
        if response.status_code == 422:
            error = response.json()["errors"][0]
            parameter = error.get("source", {}).get("parameter", "?")
            raise ValueError(f"параметр {parameter}: {error['detail']}")
        if response.status_code == 429:
            wait = int(response.headers.get("Retry-After", "60"))
            if attempt == 3:
                raise RuntimeError("квота исчерпана: " + response.text)
            time.sleep(wait)
            continue
        if response.status_code >= 500:
            time.sleep(2 ** attempt)
            continue

        # 2) платформенный конверт (404/500 вне v2) — известное ограничение
        raise RuntimeError(f"HTTP {response.status_code}: {response.text}")

    raise RuntimeError("unreachable")

print(api_get("check", {"ipAddress": "8.8.8.8", "maxAgeInDays": 90}))