DNS管理API

概要

すべてのゾーンはVPS.orgの権威あるネームサーバにホストされ，自動的にBIND9ゾーンファイルを生成し，配置する。

ネームサーバインフラストラクチャ

• ns1.vps.org (38.248.6.195) - DNSSEC インライン署名を有する主マスター
• ns2.vps.org (38.248.6.196) - 二次奴隷
• ns3.vps.org (38.248.6.197) - 二次奴隷

主要な特徴

• 自動 BIND9 ゾーンファイル生成と展開
• TSIG 認証を介したゾーン転送 (マスタースレーブ複製)
• すべての主要なDNSレコードタイプ (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA) をサポートします
• ドメイン名フィルタリングとUUIDベースのゾーン識別
• ゾーン特有のレコード管理のためのネストされたルート

認証

すべての DNS API 要求には Bearer トークン認証が必要です。アカウントのダッシュボードから API トークンを生成してください。 /account/developers/ 次の権限を持って:

• dns:list - DNS ゾーンとレコードを表示
• dns:create - 新しいゾーンとレコードを作成
• dns:update - 既存のゾーンとレコードを修正
• dns:delete - ゾーンとレコードを削除
• dns:* - DNS管理権限

例

Authorization: Bearer vps_abc123def456...

すべてのDNSゾーンを一覧表示する

認証されたユーザが所有するすべての DNS ゾーンのページリストを取得します。ドメイン名でフィルタリングをサポートします。

クエリパラメータ

リクエスト例

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

import requests

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

response = requests.get(url, headers=headers)
print(response.json())

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

const zones = await response.json();
console.log(zones);

回答例

[
  {
    "uuid": "abc123-def456-ghi789",
    "domain": "example.com",
    "created_at": "2024-01-15T10:30:00Z",
    "record_count": 12
  },
  {
    "uuid": "xyz789-uvw456-rst123",
    "domain": "myapp.io",
    "created_at": "2024-06-20T14:15:00Z",
    "record_count": 8
  }
]

応答フィールド

応答ステータスコード

DNS ゾーンの詳細を取得

特定のDNSゾーンに関する詳細な情報を取得します。すべてのレコードを含む。

パスパラメータ

回答例

{
  "uuid": "abc123-def456-ghi789",
  "domain": "example.com",
  "created_at": "2024-01-15T10:30:00Z",
  "record_count": 5,
  "records": [
    {
      "uuid": "rec-001",
      "record_type": "A",
      "name": "@",
      "value": "192.0.2.1",
      "ttl": 3600,
      "priority": null,
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "uuid": "rec-002",
      "record_type": "MX",
      "name": "@",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10,
      "created_at": "2024-01-15T10:32:00Z"
    }
  ]
}

応答ステータスコード

DNS ゾーンを作成

ドメインのための新しい DNS ゾーンを作成します。ゾーンは直ちに VPS.org のネームサーバに展開されます。

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

リクエスト例

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

import requests

url = "https://admin.vps.org/api/v1/dns-zones/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {"domain": "newdomain.com"}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/dns-zones/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({domain: 'newdomain.com'})
});

const zone = await response.json();
console.log(zone);

回答例

{
  "uuid": "new-zone-uuid",
  "domain": "newdomain.com",
  "created_at": "2026-01-18T16:45:00Z",
  "record_count": 0,
  "records": []
}

応答ステータスコード

DNS ゾーンを削除

DNS ゾーンと関連付けられたすべてのレコードを永久に削除します。この操作は元に戻せません。

パスパラメータ

応答ステータスコード

ゾーンの DNS レコードをリスト

特定のゾーン (ネストされたルート) のすべての DNS レコードを検索します。

パスパラメータ

リクエスト例

curl -X GET "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

回答例

[
  {
    "uuid": "rec-001",
    "record_type": "A",
    "name": "@",
    "value": "192.0.2.1",
    "ttl": 3600,
    "priority": null,
    "created_at": "2024-01-15T10:30:00Z"
  },
  {
    "uuid": "rec-002",
    "record_type": "MX",
    "name": "@",
    "value": "mail.example.com",
    "ttl": 3600,
    "priority": 10,
    "created_at": "2024-01-15T10:32:00Z"
  }
]

ゾーンで DNS レコードを作成

特定のゾーン (ネストされたルート) に新しい DNS レコードを追加します。

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

リクエスト例

curl -X POST "https://admin.vps.org/api/v1/dns-zones/{uuid}/records/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
  }'

import requests

url = f"https://admin.vps.org/api/v1/dns-zones/{zone_uuid}/records/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "record_type": "A",
    "name": "www",
    "value": "192.0.2.1",
    "ttl": 3600
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

応答ステータスコード

DNS レコードの管理 (直接アクセス)

個々のDNSレコードに対してレコードUUIDを使用してフル CRUD 操作を行う。

利用可能な操作

• GET /api/v1/dns-records/{uuid}/ - Retrieve record details
• PUT /api/v1/dns-records/{uuid}/ - Full update (all fields required)
• PATCH /api/v1/dns-records/{uuid}/ - Partial update (only changed fields)
• DELETE /api/v1/dns-records/{uuid}/ - Delete record

クエリパラメータ (GET /api/v1/dns-records/ の場合)

例: レコードの TTL を更新

curl -X PATCH "https://admin.vps.org/api/v1/dns-records/{rec-uuid}/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 1800}'

Supported DNS Record Types

ベストプラクティス

TTL 設定

• 生産（安定）： 3600-86400 秒 (1-24 時間)
• マイグレーション前: 300-600 秒 (5-10 分) - 計画変更前に TTL を低下
• 開発: テスト時間を短縮するために300〜1800秒（5〜30分）

共通パターン

• ルートドメイン (@): CNAME ではなく A/AAAA レコードを使う
• www サブドメイン: CNAME をルートまたは別々の A レコードに指向できる
• メール (MX): 常に優先度を含む。小さい数字は高い優先度
• CNAME: 同じ名前の他のレコードタイプと共存できません

セキュリティ

• CAAレコード 証明書を発行できる CA を指定
• ファイルを開く メール認証を設定してスプーフィングを防止しますName
• 定期的な監査: DNS レコードを季節ごとにチェックし、使われていないエントリを削除します

エラーハンドリング

よくあるエラー

エラー応答の例

{
  "detail": "MX records require a priority value",
  "error_code": "validation_error",
  "field": "priority"
}

DNS 変更をテスト

レコードの拡散を確認

# Query A record
dig example.com A

# Query specific nameserver
dig @ns1.vps.org example.com

# Query MX records
dig example.com MX

# Check all records
dig example.com ANY

オンラインツールを使う

• whatsmydns.net: Check global DNS propagation
• dnschecker.org: Multi-location DNS lookup
• mxtoolbox.com: Email-related DNS testing