Netbudur Logo
api.netbudur.com / v1
01

Netbudur
REST API

VDS altyapısını kendi panelinize, otomasyonunuza veya uygulamanıza bağlayın. Hizmetleri yönetin; sipariş ve yenilemeleri tek API üzerinden tamamlayın.

Anahtar oluştur ↗OpenAPI şemasını indir ↓
API EXPLORER200 OK
GET/rest/v1/vds
Authorization: Bearer nb_live_••••••••
Accept: application/json
RESPONSE84 ms
{
  "data": [{
    "id": "10482",
    "status": "active",
    "power": "running"
  }]
}
01 REST / JSON02 Scope tabanlı erişim03 IPv4 + IPv6 kısıtlama04 Çift işlem koruması

Genel bakış

Tüm uç noktalar aşağıdaki temel adresi kullanır. İstek ve yanıt gövdeleri UTF-8 JSON’dur. Tutarlar USD, tarihler ISO 8601 biçimindedir.

BASE URLHTTPS
https://netbudur.com/rest/v1
İstek takibiHer yanıtta bulunan X-Request-Id değerini destek taleplerinizde paylaşın.

Kimlik doğrulama

Müşteri panelinden oluşturduğunuz anahtarı Bearer başlığında gönderin. Anahtarları uygulama bazında ayırın; yalnızca gereken yetkileri ve sabit IP adreslerini tanımlayın.

HTTP HEADERBearer
Authorization: Bearer nb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Yetki kapsamları

profile:read, wallet:read, plans:read, vds:read/write, domains:read/write, hosting:read/write, dedicated:read/write y orders:write.

IP izin listesi

Bir anahtara en fazla 20 IPv4 veya IPv6 ekleyebilirsiniz. Liste doluysa diğer tüm adresler 403 ip_not_allowed alır.

İlk isteğinizi gönderin

Aşağıdaki çağrı hesabınıza ait VDS hizmetlerini listeler.

cURLGET /vds
curl "https://netbudur.com/rest/v1/vds" \
  -H "Authorization: Bearer $NETBUDUR_API_KEY" \
  -H "Accept: application/json"
RESPONSE200 OK
{
  "data": [
    {"id":"10482","name":"NVMe VDS","ip_address":"203.0.113.10","status":1}
  ],
  "meta": {"request_id":"2a5c..."}
}

VDS API

Sanal sunucu paketleri, hizmet ayrıntıları, sipariş, yenileme ve güç yönetimi.

01VDS API uç noktaları

Kaynaklar yalnızca API anahtarının sahibi olan müşterinin hesabından döndürülür.

GET/plans
plans:read · Satıştaki VDS paketleri
GET/vds
vds:read · Hesaba ait VDS hizmetleri
GET/vds/{id}
vds:read · VDS ayrıntısı
POST/orders/vds
orders:write · Bakiyeden VDS siparişi
POST/vds/{id}/renew
orders:write · VDS süre uzatma
POST/vds/{id}/actions
vds:write · Başlatma, kapatma ve yeniden başlatma

Domain API

Alan adı sorgulama, satın alma, yenileme ve registrar ayarları.

02Domain API uç noktaları

Kaynaklar yalnızca API anahtarının sahibi olan müşterinin hesabından döndürülür.

GET/domain/search
domains:read · Uygunluk ve güncel satış fiyatı
GET/domains
domains:read · Hesaba ait domain hizmetleri
GET/domains/{id}
domains:read · Domain ayrıntısı
POST/orders/domain
orders:write · Bakiyeden domain satın alma
POST/domains/{id}/renew
orders:write · Domain yenileme
POST/domains/{id}/nameservers
domains:write · Nameserver güncelleme
POST/domains/{id}/lock
domains:write · Registrar kilidi açma veya kapatma
POST/domains/{id}/auto-payment
domains:write · Otomatik yenileme yöntemi

Hosting API

Web hosting paketleri, lokasyonlar, siparişler ve panel erişimi.

03Hosting API uç noktaları

Kaynaklar yalnızca API anahtarının sahibi olan müşterinin hesabından döndürülür.

GET/hosting/plans
plans:read · Hosting paketleri ve dönem fiyatları
GET/hosting/locations
plans:read · Aktif hosting lokasyonları
GET/hosting
hosting:read · Hesaba ait hosting hizmetleri
GET/hosting/{id}
hosting:read · Hosting ayrıntısı
POST/orders/hosting
orders:write · Bakiyeden hosting satın alma
POST/hosting/{id}/renew
orders:write · Hosting süre uzatma
POST/hosting/{id}/auto-payment
hosting:write · Otomatik yenileme yöntemi
POST/hosting/{id}/sso
hosting:write · Tek kullanımlık cPanel veya webmail bağlantısı

Dedicated API

Fiziksel sunucu paketleri, donanım seçenekleri, sipariş ve hizmet yenileme işlemleri.

04Dedicated API uç noktaları

Kaynaklar yalnızca API anahtarının sahibi olan müşterinin hesabından döndürülür.

GET/dedicated/plans
plans:read · Müsait dedicated paketleri ve dönem fiyatları
GET/dedicated/options
plans:read · IPv4, IPv6 ve işletim sistemi seçenekleri
GET/dedicated
dedicated:read · Hesaba ait dedicated hizmetleri
GET/dedicated/{id}
dedicated:read · Dedicated hizmet ayrıntısı
POST/orders/dedicated
orders:write · Bakiyeden dedicated siparişi
POST/dedicated/{id}/renew
orders:write · Dedicated süre uzatma
POST/dedicated/{id}/auto-payment
dedicated:write · Otomatik yenileme yöntemi

Yeni VDS siparişi

Paketin güncel bedeli kredi bakiyesinden atomik olarak düşülür ve kurulum siparişi oluşturulur. Ağ hatalarında aynı idempotency anahtarıyla tekrar deneyebilirsiniz.

cURLPOST /orders/vds
curl -X POST "https://netbudur.com/rest/v1/orders/vds" \
  -H "Authorization: Bearer $NETBUDUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-2026-0001" \
  -d '{"plan_id":3,"hostname":"app-01","os":"ubuntu-24.04"}'

Hizmet süresini uzatma

VDS’nin güncel yenileme bedeli krediden düşülür ve uzatma işlemi sipariş kuyruğuna alınır.

cURLPOST /vds/{id}/renew
curl -X POST "https://netbudur.com/rest/v1/vds/10482/renew" \
  -H "Authorization: Bearer $NETBUDUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: renew-10482-2026-11" \
  -d '{}'

Hatalar

HTTPKodAnlamı
400validation_errorEksik veya hatalı alan
401unauthorizedAnahtar geçersiz veya süresi dolmuş
402insufficient_balanceKredi bakiyesi yetersiz
403ip_not_allowedBağlanan IP izin listesinde değil
404not_foundKaynak yok veya müşteriye ait değil
409idempotency_conflictAnahtar farklı istekle kullanılmış
ERROR RESPONSE403
{"error":{"code":"ip_not_allowed","message":"Bu IP adresinin API anahtarını kullanma izni yok."},"meta":{"request_id":"..."}}

Güvenlik önerileri

Anahtarı gizli tutun

Kaynak koda veya tarayıcı JavaScript’ine koymayın. Sunucu tarafında şifreli secret olarak saklayın.

IP sınırlandırın

Üretim anahtarlarında uygulama sunucularınızın sabit çıkış IP’lerini tanımlayın.

En az yetki verin

Sadece listeleme yapan bir entegrasyona sipariş veya VDS yönetim yetkisi vermeyin.

Düzenli yenileyin

Kısa geçerlilik seçin, eski anahtarı iptal edin ve şüpheli kullanımlarda hemen değiştirin.

¿Cómo puedo ayudar?