対象ユーザー
1つの意思決定には焦点化された検査を使い、コンテキストが重要な場合は広いプロファイルを組み立てます。
得られるもの
ドメイン名が 1 つ以上の TLD 全体で利用可能かどうかを確認します。
同期一括RESTMCPSDKインタラクティブツール
この製品を選ぶ場面
この製品を選ぶ場面
利用可能、登録済み、不明のステータスと裏付け証拠が必要なときに選びます。利用可能でも登録できる保証はありません。
得られるもの
ドメイン名が 1 つ以上の TLD 全体で利用可能かどうかを確認します。
エンドポイント
統合する前に、サポートされる操作、入力、出力、実行モード、レスポンス制限を確認してください。
クレジットと認証
1 認証が必要。正確な料金と項目ごとの料金については、操作リファレンスを確認してください。
操作例
文書化された操作を使って、公開証拠を収集、評価、補足、検証、比較、保護、監視します。
GET
/v1/status
クレジット: 1
クエリパラメータ
| パラメータ | タイプ | 必須 |
|---|---|---|
| name | string | オプション |
| tlds | string | オプション |
| domain | string | オプション |
| prefer_cache |
boolean
デフォルト
false
|
オプション |
レスポンスフィールド
| フィールド | タイプ |
|---|---|
cache_age_s |
integer |
name |
string |
results[] |
object[] |
results[] |
object |
results[].classification |
object |
results[].classification.status |
string |
results[].classification.reason |
string |
results[].classification.evidence |
object |
results[].classification.evidence.source |
string |
results[].classification.evidence.method |
string |
results[].classification.evidence.observed_at |
string |
results[].classification.evidence.detail |
string |
results[].classification.checked_at |
string |
results[].domain |
string |
results[].tld |
string |
results[].available |
boolean | null |
results[].availability_reason |
string |
results[].source |
string |
results[].confidence |
string |
results[].checked_at |
string |
results[].latency_ms |
integer |
results[].cache_age_s |
integer |
results[].registry_status[] |
string[] |
results[].rdap_events[] |
object[] |
results[].rdap_events[] |
object |
results[].rdap_events[].eventAction |
string |
results[].rdap_events[].eventDate |
string |
results[].proof |
object |
results[].dns_status |
object |
results[].dns_status.has_nameservers |
boolean |
results[].dns_status.resolvable |
boolean |
results[].dns_status.checked |
boolean |
results[].timing |
object |
results[].timing.cache_lookup_ms |
integer |
results[].timing.rdap_query_ms |
integer |
results[].timing.dns_check_ms |
integer |
results[].timing.total_ms |
integer |
results[].status_flags[] |
string[] |
results[].status |
string |
results[].lifecycle_phase |
string |
results[].is_public_suffix |
boolean |
results[].error |
object |
results[].error.code |
string |
results[].error.message |
string |
results[].error.suggestion |
string |
results[].error.cause |
string |
scope |
string |
confidence_summary |
object |
confidence_summary.scope |
string |
confidence_summary.requested_count |
integer |
confidence_summary.result_count |
integer |
confidence_summary.invalid_count |
integer |
confidence_summary.available_count |
integer |
confidence_summary.registered_count |
integer |
confidence_summary.restricted_count |
integer |
confidence_summary.authoritative_count |
integer |
confidence_summary.heuristic_count |
integer |
confidence_summary.cached_count |
integer |
confidence_summary.error_count |
integer |
confidence_summary.ambiguous_count |
integer |
confidence_summary.source_counts |
object |
confidence_summary.primary_source |
string | null |
confidence_summary.cache_status |
string |
confidence_summary.rdap_calls |
integer |
confidence_summary.refreshes |
integer |
confidence_summary.cache_preference_misses |
integer |
confidence_summary.fallback_chain[] |
string[] |
confidence_summary.confidence_level |
string |
confidence_summary.determinacy_rate |
number |
confidence_summary.ambiguity_reason |
string | null |
meta |
object |
meta.total_checked |
integer |
meta.available_count |
integer |
meta.duration_ms |
integer |
meta.served_by |
string |
meta.scope_description |
string |
リクエスト例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false"const response = await fetch("https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))レスポンス例
{
"name": "mycompany",
"results": [
{
"domain": "mycompany.com",
"tld": "com",
"available": false,
"source": "rdap",
"latency_ms": 45
},
{
"domain": "mycompany.io",
"tld": "io",
"available": true,
"source": "rdap",
"latency_ms": 67
}
],
"meta": {
"total_checked": 2,
"available_count": 1,
"duration_ms": 120
}
}HTTP ステータスコード
200成功400不正なリクエスト401未認証402支払いが必要429リクエスト過多
よくある質問
ドメイン可用性を確認のリクエストとレスポンスのリファレンスはどこで確認できますか？
ドメイン可用性を確認のAPIリファレンスで、パラメーター、レスポンスフィールド、例、ステータスコード、サポートされる操作モードを確認できます。
ドメイン可用性を確認の不明または不完全な結果はどのように解釈すべきですか？
不明または部分的な結果は、要求された証拠を完全には判定できなかったことを意味します。下流の判断では、結果の状態、信頼度、鮮度、制限を維持してください。
ドメイン可用性を確認の料金はどのように決まりますか？
料金は操作と実行モードによって異なります。現在のクレジット料金、認証要件、項目ごとのルールについては、エンドポイントリファレンスを確認してください。
