ドメインAPI

すべてのドメインを一覧表示する

あなたのアカウントに登録されているドメインを表示します。ページ当たり 25 個です。リストにはフィルタはありません。

必要な権限: domains:list

リクエスト例

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

回答例

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

応答フィールド

ドメインの詳細を取得

上記のフィールドを持つドメインオブジェクトを返します。

必要な権限: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

応答ステータスコード

ドメイン利用可能性を検索

約 20 の一般的な拡張子 (com, net, org, io, dev, co, app, ai など) で名前が利用可能かどうかをチェックします。それに、タイプした拡張子がその中にない場合は追加します。結果は正確な一致から始まり、利用可能な名前、既に使われている名前を表示します。

必要な権限: domains:search

リクエストボディパラメータ

リクエスト例

curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'

import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

回答例

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

価格は1年間のUSDで表され、利用できない名前は null です。表示されている価格は説明用です。

応答ステータスコード

新しいドメインを登録する

ドメインを登録し、保存した支払い方法を請求します。利用可能性と価格は、請求の直前にレジスタントと再確認されます。登録者の連絡先情報は、あなたのアカウントプロファイルから取得されます。登録者が登録を拒否した場合、請求後に支払いは返金されます。

必要な権限: domains:register あなたは 私のために あなたの 心を 捧げる

リクエストボディパラメータ

curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

回答例

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

応答ステータスコード

ドメインを更新

ドメインを更新し、毎年の更新料を保存された支払い方法に請求します。

必要な権限: domains:renew

リクエストボディパラメータ

curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

応答ステータスコード

名前サーバを更新

登録者にドメインの名前サーバを設定し、更新されたドメインオブジェクトを返します。DNS APIで DNS を管理するには、ns1.vps.org、ns2.vps.org、ns3.vps.orgを使ってドメインのゾーンを作成します。

必要な権限: domains:update

リクエストボディパラメータ

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

応答ステータスコード

自動更新を有効/無効にします

auto_renew を設定し、更新されたドメインオブジェクトを返します。JSON ブルーンとして送信すると、空でない文字列は自動更新を有効にします。 false 文字列も含まれます。

必要な権限: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

応答ステータスコード

ノート

• これは、ドメインを削除したり、ドメインを移動したり、WHOIS プライバシーや移動ロックを変更したりすることはできません。移動と削除は、admin.vps.org のコントロールパネルで行えます。
• ドメインのＤＮＳレコードはＤＮＳＡＰＩで管理される。 DNS管理API