APIドキュメント

v1.6

Next Whoisは、プログラマティックなWHOIS/RDAPルックアップと動的OG画像生成のためのシンプルなREST APIを提供します。すべてのエンドポイントは公開されており、認証は不要です。

GET

/api/lookup

ドメイン、IPアドレス、ASN、またはCIDR範囲のWHOIS/RDAP情報を照会します。RDAPとWHOISは並行して照会され、構造化フィールドはRDAPデータを優先し、WHOISにフォールバックします。両方の生のレスポンスが含まれます。

パラメータ

パラメータ	タイプ	必須	デフォルト	説明
query	string	必須	—	ドメイン名、IPv4/IPv6アドレス、ASN（例：AS13335）、またはCIDR範囲。エイリアス：q

リクエスト例

curl "https://your-domain.com/api/lookup?query=google.com"

成功レスポンス

{
  "status": true,
  "time": 1.23,
  "cached": false,
  "source": "rdap",
  "result": {
    "domain": "google.com",
    "registrar": "MarkMonitor Inc.",
    "registrarURL": "http://www.markmonitor.com",
    "ianaId": "292",
    "whoisServer": "whois.markmonitor.com",
    "creationDate": "1997-09-15T04:00:00Z",
    "expirationDate": "2028-09-14T04:00:00Z",
    "updatedDate": "2019-09-09T15:39:04Z",
    "status": [
      { "status": "clientDeleteProhibited", "url": "..." },
      { "status": "clientTransferProhibited", "url": "..." }
    ],
    "nameServers": ["ns1.google.com", "ns2.google.com", "ns3.google.com", "ns4.google.com"],
    "dnssec": "unsigned",
    "domainAge": 28,
    "remainingDays": 945,
    "rawWhoisContent": "Domain Name: GOOGLE.COM\nRegistry Domain ID: ...",
    "rawRdapContent": "{\n  \"objectClassName\": \"domain\",\n  ...\n}"
  }
}

エラーレスポンス

{
  "status": false,
  "time": 0.45,
  "error": "No match for domain \"EXAMPLE.INVALID\""
}

GET

/api/og

WHOIS詳細を含む動的なOpen Graph画像を生成します。内部的に/api/lookupを照会し、カードスタイルのサマリーをレンダリングします。PNG画像を返します。

パラメータ

パラメータ	タイプ	必須	デフォルト	説明
query	string	任意	—	ルックアップして表示するドメイン、IP、ASN、またはCIDR。エイリアス：q
w	number	任意	1200	画像の幅（ピクセル、200-4096）
h	number	任意	630	画像の高さ（ピクセル、200-4096）
theme	string	任意	light	カラーテーマ："light" または "dark"

リクエスト例

curl "https://your-domain.com/api/og?query=google.com&theme=dark" -o og.png

プレビュー

/api/og?query=google.com

レート制限とキャッシュ

成功したWHOISルックアップレスポンスはサーバー側（Redis）でキャッシュされ、

Cache-Control: s-maxage=3600, stale-while-revalidate=86400

ヘッダーと共に提供されます。

キャッシュされたレスポンスには

"cached": true

がJSON本文に含まれ、

"time": 0

Next Whois v1.6 · whois