API domenii

Listați toate domeniile

Returnează domeniile înregistrate în contul dvs., 25 pe pagină. Lista nu are filtre.

Permisul necesar: domains:list

Exemplu de solicitare

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

Exemplu de răspuns

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

Câmpuri de răspuns

Obține detalii de domeniu

Returnă un obiect de domeniu cu câmpurile de mai sus.

Permisul necesar: domains:list

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

Coduri de stare a răspunsului

Caută Disponibilitatea domeniului

Verifica dacă un nume este disponibil în aproximativ 20 de extensii populare (com, net, org, io, dev, co, aplicație, ai și mai multe), plus extensia pe care le-ai scris dacă nu este printre ele. Rezultatele încep cu meciul exact, apoi numele disponibile, apoi luate unul.

Permisul necesar: domains:search

Parametrii corpului cererii

Exemplu de solicitare

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"])

Exemplu de răspuns

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

Prețurile sunt numere în USD pentru un an și sunt nule pentru nume care nu sunt disponibile. Prețurile prezentate sunt ilustrative.

Coduri de stare a răspunsului

Înregistrați un domeniu nou

Înregistrează un domeniu și tarifează metoda de plată salvată. Disponibilitatea și prețul sunt verificate cu registratorul din nou chiar înainte de taxă. Datele de contact înregistrat sunt luate din profilul contului. Dacă registratorul respinge înregistrarea după taxă, plata este rambursată.

Permisul necesar: domains:register (reducete de domenii:*)

Parametrii corpului cererii

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}'

Exemplu de răspuns

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

Coduri de stare a răspunsului

Reînnoiește un domeniu

Renouvează domeniul și tarifează reînnoirea_price pentru fiecare an la metoda de plată salvată.

Permisul necesar: domains:renew

Parametrii corpului cererii

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)!"
}

Coduri de stare a răspunsului

Actualizare servere de nume

Setați serverele de nume de domeniu la registrar și returnează obiectul de domeniu actualizat. Pentru a gestiona DNS cu API DNS, utilizați ns1.vps.org, ns2.vps.org și ns3.vps.org și creați o zonă pentru domeniu.

Permisul necesar: domains:update

Parametrii corpului cererii

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"}'

Coduri de stare a răspunsului

Întoarce sau oprire automată

Setează auto_renou și returnează obiectul de domeniu actualizat. Trimite activat ca un boolean JSON: orice string nezbrăcat, inclusiv cordonul fals, se activează auto-reînnoierea.

Permisul necesar: 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}'

Coduri de stare a răspunsului

Note

• API nu poate șterge un domeniu, transfera un domeniu în sau schimba confidențialitatea WHOIS sau blocarea transferului. Transferurile și ștergerea sunt disponibile în panoul de control la admin.vps.org.
• Înregistrările DNS pentru un domeniu sunt gestionate cu API DNS. API-ul de gestionare DNS