도메인 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!"
}

응답 상태 코드

도메인 갱신

도메인을 갱신하고 저장된 결제 방법으로 각 연도에 대한 renewal_price를 청구합니다.

필요한 권한: 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 를 사용하여 도메인에 대한 영역을 생성합니다. ns1.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"}'

응답 상태 코드

자동 갱신 켜기 또는 끄기

Send enabled as a JSON boolean: 문자열 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}'

응답 상태 코드

메모

• API는 도메인을 삭제하거나, 도메인을 옮기거나, WHOIS 개인정보 보호 또는 전송 잠금을 변경할 수 없습니다. 전송 및 삭제는 admin.vps.org의 제어판에서 가능합니다.
• 도메인에 대한 DNS 레코드는 DNS API를 사용하여 관리됩니다. DNS 관리 API