Документация

API

HTTP- и JSON API

Без аутентификации

Основные endpoints не требуют аккаунта или cookie. Динамические ответы используют Cache-Control: no-store и заголовки ограничения запросов.

API v1

Стабильный JSON

Версионированный snake_case JSON со стабильным контрактом для своего и заданного IP.

GET/api/v1/self

Структурированный результат для текущего IP с полями сети, местоположения и ASN.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

Структурированный поиск проверенного адреса IPv4 или IPv6.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

Совместимость

Путь	Ответ
`GET /`	Корневой путь с согласованием содержимого: JSON для CLI и /, один IP для text/plain и SSR HTML при явном запросе text/html.
`GET /json`	Структурированный результат для текущего IP с полями сети, местоположения и ASN.
`GET /json/{ip}`	Структурированный поиск проверенного адреса IPv4 или IPv6.
`GET /ip/{ip}`	Нормализованный целевой IP для программ; страница noindex только при явном запросе HTML.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

Терминал

TEXT / ANSI

Путь	Ответ
`GET /ip`	Нормализованный текущий IP и один перевод строки.
`GET /info[/{ip}]`	Подробный текст UTF-8 со стабильными метками и порядком, без управляющих кодов ANSI.
`GET /ansi[/{ip}]`	Представление /info с явно включёнными разрешёнными цветами SGR.
`GET /field/{field}[/{ip}]`	Одно разрешённое значение и перевод строки; 204, если данных нет.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

Методика и границы сигналов

Сервис разделяет сетевые данные, наблюдаемые сервером, локальные геоданные и сигналы браузера, чтобы не выдавать один источник за другой.

Показанный публичный IP — это адрес, который сервис наблюдает для данного HTTP-соединения.
Страна, регион, город, часовой пояс, координаты, ASN и организация берутся из локального набора данных.
Проверки WebRTC, DNS, языка, часового пояса и IPv6 являются независимыми наблюдениями в браузере.
Недоступно, неизвестно, нет наблюдения и несовпадение — разные состояния.

Точность и актуальность

IP-геолокация описывает сетевой диапазон, а не устройство или дом. Город и координаты могут быть далеко от пользователя; радиус точности — оценка неопределённости, а не гарантия.

Конфиденциальность и хранение

Поиск не записывает исходные IP, URI, заголовки или отпечатки в агрегаты PostgreSQL. Подписанные ссылки содержат только сокращённые статусы, истекают через 24 часа и не сохраняются как записи.

Частые вопросы

Показанный город — моё точное местоположение?

Нет. IP-геолокация — приблизительная оценка на уровне сети. Учитывайте радиус точности и не считайте координаты точным адресом.

Сохраняет ли сервис мой IP-запрос в базе данных?

Приложение не хранит исходные IP-адреса в агрегатах использования. Ограниченные журналы веб-доступа обрабатываются отдельно.

Почему IPv6 может быть неизвестен, а не недоступен?

Ненастроенная, заблокированная или неубедительная проверка не доказывает отсутствие IPv6; до ясного результата статус остаётся неизвестным.

Что содержится в ссылке для обмена диагностикой?

Только сокращённые статусы, время выпуска и истечения и подпись; без IP, координат и адресов DNS-резолверов.