API
Те же данные, что и на сайте, в виде JSON или простого текста. Без ключа и регистрации; действуют ограничения добросовестного использования.
curl https://ipaddress.ae/api/v1/my-ip?format=textКонечные точки
| Путь | Описание | Данные | Ограничения частоты |
|---|---|---|---|
| GET/api/v1/my-ipПопробуйте: /api/v1/my-ip | Ваш IP-адрес (также простым текстом с ?format=text). | Собственные данные | 120 · 240/мин |
| GET/api/v1/ip/{address}Попробуйте: /api/v1/ip/1.1.1.1 | Данные о сети, маршрутизации, реестре и местоположении адреса. | Собственные данные | 30 · 30/мин |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ae/api/v1/bulk | До 100 адресов за раз (JSON {"addresses": […]} или по одному в строке), ответы только из наших собственных данных. Ничего не сохраняется. | Собственные данные | 6 · 3/мин |
| GET/api/v1/asn/{asn}Попробуйте: /api/v1/asn/AS5384 | Держатель, реестр и анонсируемые префиксы автономной системы. | Собственные данные | 30 · 30/мин |
| GET/api/v1/dns/{domain}?type=A,MXПопробуйте: /api/v1/dns/internetnz.nz?type=A,MX | Записи DNS домена в реальном времени. | Запрос в реальном времени | 40 · 60/мин |
| GET/api/v1/rdap/{query}Попробуйте: /api/v1/rdap/AS5384 | Регистрационные данные от ответственного сервера RDAP. | Запрос в реальном времени | 10 · 6/мин |
| GET/api/v1/healthПопробуйте: /api/v1/health | Доступность сервиса. | Собственные данные | 120 · 240/мин |
| GET/api/v1/data-statusПопробуйте: /api/v1/data-status | Возраст и размер каждого набора данных. | Собственные данные | 120 · 240/мин |
Ограничения частоты
Запросы ограничиваются для каждого клиентского адреса по алгоритму token bucket. При достижении лимита API отвечает кодом 429 с заголовком Retry-After. Лимиты считаются в памяти по хешированному ключу, который меняется ежедневно; адреса не сохраняются.
Ошибки
Ошибки возвращаются с кодами состояния HTTP и телом JSON вида {"error": {"code": "…", "message": "…"}}.
Версии
Пути в /api/v1/ сохраняют структуру ответа. Могут добавляться новые поля; существующие поля в рамках v1 не удаляются и не переименовываются.
Указание источника
Данные о местоположении предоставлены DB-IP (CC BY 4.0). Если вы их показываете, укажите DB-IP, как требует лицензия.