🚀

BETA verze webu! Postupně přidáváme další funkce. Připojte se na náš Discord server pro nejnovější aktualizace.

</>
ihos.eu
← Zpět na WHOIS

WHOIS API Dokumentace

Kompletní dokumentace pro použití IHOS.eu WHOIS API služby

Přehled
v1.0
IHOS.eu WHOIS API poskytuje informace o doménách a IP adresách

WHOIS API umožňuje programově získávat informace o doménách a IP adresách. API poskytuje data o registraci domén, dostupnosti, registrátorech, DNS serverech a další informace. Pro IP adresy poskytuje geolokační data, informace o poskytovateli a další technické detaily.

Endpointy
Dostupné API endpointy
GET
/api/whois

Hlavní endpoint pro získání WHOIS informací o doméně nebo IP adrese.

Parametry
Parametr
Typ
Povinný
Popis
domain
string
Ano*
Doménové jméno pro vyhledání (např. example.com)
ip
string
Ano*
IP adresa pro vyhledání (např. 8.8.8.8)

* Je vyžadován buď parametr domain nebo ip

Odpověď pro doménové dotazy
Struktura odpovědi při dotazu na doménu
Úspěšná odpověď (200 OK)
{
  "type": "domain",
  "domain": "example.com",
  "available": false,
  "protocol": "WHOIS",
  "source": "whois.verisign-grs.com",
  "registrar": "Example Registrar, LLC",
  "created": "1995-08-14T04:00:00Z",
  "updated": "2023-08-14T07:01:44Z",
  "expires": "2024-08-13T04:00:00Z",
  "status": [
    "clientDeleteProhibited",
    "clientTransferProhibited",
    "clientUpdateProhibited"
  ],
  "nameservers": [
    "a.iana-servers.net",
    "b.iana-servers.net"
  ],
  "registrant": {
    "privacy": true,
    "organization": "REDACTED FOR PRIVACY",
    "country": "US"
  },
  "ipAddresses": [
    "93.184.216.34"
  ],
  "serverInfo": {
    "ip": "93.184.216.34",
    "hostname": "example.com",
    "city": "Norwell",
    "region": "Massachusetts",
    "country": "US",
    "loc": "42.1508,-70.8228",
    "org": "AS15133 MCI Communications Services, Inc. d/b/a Verizon Business",
    "postal": "02061",
    "timezone": "America/New_York"
  }
}
Odpověď pro dostupnou doménu
{
  "type": "domain",
  "domain": "available-domain-example123.com",
  "available": true
}
Odpověď pro blokovanou doménu (403 Forbidden)
{
  "error": "WHOIS query blocked",
  "details": "This domain has WHOIS lookup disabled by the domain owner",
  "domain": "ihos.eu",
  "blocked": true
}
Příklady použití
Ukázky použití API v různých programovacích jazycích
// Dotaz na doménu
async function checkDomain(domain) {
  try {
    const response = await fetch(`https://ihos.eu/api/whois?domain=${encodeURIComponent(domain)}`);
    const data = await response.json();
    
    if (response.ok) {
      console.log('Doménové informace:', data);
      return data;
    } else {
      console.error('Chyba:', data.error);
      return null;
    }
  } catch (error) {
    console.error('Chyba při dotazu:', error);
    return null;
  }
}

// Dotaz na IP adresu
async function checkIP(ip) {
  try {
    const response = await fetch(`https://ihos.eu/api/whois?ip=${encodeURIComponent(ip)}`);
    const data = await response.json();
    
    if (response.ok) {
      console.log('IP informace:', data);
      return data;
    } else {
      console.error('Chyba:', data.error);
      return null;
    }
  } catch (error) {
    console.error('Chyba při dotazu:', error);
    return null;
  }
}

// Použití
checkDomain('example.com');
checkIP('8.8.8.8');
Chybové kódy
Seznam možných chybových kódů a jejich význam
Chybové odpovědi
HTTP kód
Chybový kód
Popis
400 Bad Request
MISSING_PARAMETER
Chybí povinný parametr (domain nebo ip)
400 Bad Request
INVALID_FORMAT
Neplatný formát domény nebo IP adresy
403 Forbidden
WHOIS_BLOCKED
WHOIS dotaz je blokován pro tuto doménu
429 Too Many Requests
RATE_LIMIT
Překročen limit počtu požadavků
500 Internal Server Error
SERVER_ERROR
Interní chyba serveru
504 Gateway Timeout
TIMEOUT
Vypršel časový limit pro WHOIS dotaz
Podpora a kontakt

Máte otázky nebo potřebujete pomoc s integrací API?

Technická podpora

Pro technické dotazy a pomoc s integrací API nás kontaktujte na:

[email protected]

Komerční dotazy

Pro informace o komerčním využití a vyšších limitech:

[email protected]
Podmínky použití

Použitím IHOS.eu WHOIS API souhlasíte s následujícími podmínkami:

  • API je poskytováno "tak jak je" bez jakýchkoliv záruk.
  • Nepoužívejte API pro hromadné stahování dat nebo automatizované skenování.
  • Respektujte limity API (60 požadavků za minutu).
  • Nepoužívejte získaná data pro spam nebo jiné škodlivé účely.
  • IHOS.eu si vyhrazuje právo omezit nebo zablokovat přístup k API při porušení těchto podmínek.
  • Pro komerční použití nás kontaktujte na [email protected].