DNS פאַרוואַלטונג API

איבערבליק

די DNS API גיט אַ גאַנץ מאַנאַגעמענט פֿון DNS זאָנעס און רעקאָרדס. אַלע זאָנעס זענען געװאָסט אויף 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, A, CNAME, MX, TXT, NS, SRV, CAA)
• דאָמענין נאָמען פֿילטער און UUID-באזירטע זאָנע אידענטיטעט
• געװײנטלעכע װײַזן פֿאַר זאָנע־ספּעציפֿישע אױסשרײַב־װײַזונג

אויטענטיפֿיקאַציע

אַלע DNS API־פֿירער דאַרפן אַ װײַזער־טאָקען־אַװענטירונג. שאַפֿן API־טאָקענען פֿון דיין קאָנטאָן־דאַסקבאָאַר אין /account/developers/ מיט די פאלגענדע רעכטן:

• dns:list - װײַז DNS זאָנעס און אױספֿאָרסונגען
• dns:create - סעלעקציע:
• dns:update - טעקסט פֿאַרבundo-type
• 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־זאָנע, אַרײַנגעזעצט אַלע אױסשרײַבונגען

וועג פּאַראַמעטערס

בייַשפּיל ענטפער

{
  "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"
    }
  ]
}

ענטפער סטאַטוס קאָדעס

סעלעקציע:

Create a new DNS zone for a domain. The zone will be immediately deployed to VPS.org nameservers.

פארלאנג גוף פאראמעטערס

בייַשפּיל בקשה

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־אַרײַנשרײַבונגען פֿאַר אַ באַזונדערע זאָנע (אַרײַנגעפֿאַלענע װירע)

וועג פּאַראַמעטערס

בייַשפּיל בקשה

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־אַרײַנשרײַב צו אַ באַזונדערער זאָנע (אַרײַנגעפֿאַלענע װירע)

פארלאנג גוף פאראמעטערס

בייַשפּיל בקשה

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())

ענטפער סטאַטוס קאָדעס

װײַז/היטן װײַז־פֿאָרעם

פֿולע CRUD־אָפּעראַציעס אױף אײנעלעכע DNS־אַרײַנשרײַבונגען מיט דער UUID־אַרײַנשרײַבונג

אױסגלײַכונג

• 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/)

װײַז װיפֿל

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

בעסטער־פּראָצעס

צופּאַסונג

• פּראָדוקציע (שטאַרק): 3600־86400 סעקונדעס (1־24 שעה)
• פֿאָרױסװײַז 300־600 סעקונדעס (5־10 מינוט) — אַראָפּנעמען TTL איידער געפּלאַנעטע ענדערונגען
• אַנטוויקלונג: 300-1800 סעקונדעס (5-30 מינוט) פֿאַר אַ שנעלערע דורכקוק

קלײַב אַלץ אױסundo-type

• רוט־דאָמאַין (@): ניצן A/A אױסשרײַבונגען, ניט CNAME
• www אונטערדאָמאַין: קען ניצן CNAME װי אַ װײַזער צום רוט אָדער צום צעטיילטן אײנס
• E-מײַל (MX): אַלץ אַרײַננעמען פּריאָריטעט, קלענערער נומער = העכערער פּריאָריטעט
• נאָמען: ניט קײן קאָ-עקסיסטירנדיקע מיט אַנדערע אױסשרײַב־סאָרטן מיטן זעלבן נאָמען

זיכערהײט

• CAA אױספֿאָרסונגען: באַשטעטיק װאָסערע CAס קענען אַרויסגעבן זשורנאַלן
• SPF/DKIM/DMARC: באַשטעטיק אױסגלײַכונג
• נאָרמאַל איבערזעצן 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