Servers API - VPS.org

ELDE ETMEK /api/v1/servers/

Tüm Sunucuları Listele

Hesabınızdaki tüm sunucuların listesini alın.

Sorgu Parametreleri

Parametre	Tip	Gerekli	Tanım
`status`	sicim	HAYIR	Sunucu durumuna göre filtrele: aktif, durduruldu, askıya alındı
`location`	sicim	HAYIR	Veri merkezi konumuna göre filtrele

Örnek Talep

cURL

Python

JavaScript

PHP

curl -X GET "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

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

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$servers = json_decode($response, true);
curl_close($ch);

Örnek Yanıt

{
  "count": 2,
  "results": [
    {
      "id": 12345,
      "name": "web-server-01",
      "hostname": "web01.example.com",
      "status": "active",
      "ip_address": "203.0.113.10",
      "location": "us-west",
      "plan": {
        "id": 1,
        "name": "Standard VPS",
        "vcpus": 2,
        "memory": 4096,
        "storage": 80
      },
      "os": {
        "id": 5,
        "name": "Ubuntu 22.04 LTS"
      },
      "created_at": "2025-01-10T14:30:00Z",
      "updated_at": "2025-01-15T10:20:00Z"
    },
    {
      "id": 12346,
      "name": "db-server-01",
      "hostname": "db01.example.com",
      "status": "active",
      "ip_address": "203.0.113.11",
      "location": "us-east",
      "plan": {
        "id": 2,
        "name": "Performance VPS",
        "vcpus": 4,
        "memory": 8192,
        "storage": 160
      },
      "os": {
        "id": 3,
        "name": "Debian 12"
      },
      "created_at": "2025-01-12T09:15:00Z",
      "updated_at": "2025-01-16T08:45:00Z"
    }
  ]
}

Yanıt Durum Kodları

200	Sunucu listesi başarıyla alındı.
401	Yetkisiz - Geçersiz veya eksik API belirteci

POSTALAMAK /api/v1/servers/

Yeni Sunucu Oluştur

Belirtilen yapılandırmayla yeni bir VPS sunucusu kurun.

İstek Gövdesi Parametreleri

Parametre	Tip	Gerekli	Tanım
`name`	sicim	Evet	Sunucu adı (alfanümerik, tirelere izin verilir)
`plan_id`	tamsayı	Evet	VPS planının kimliği
`os_id`	tamsayı	Evet	işletim sisteminin kimliği
`location`	sicim	Evet	Veri merkezi konum kodu
`hostname`	sicim	HAYIR	Sunucu ana bilgisayar adı (FQDN)
`ssh_key_id`	tamsayı	HAYIR	SSH anahtar kimliği
`backups_enabled`	mantıksal	HAYIR	Otomatik yedeklemeleri etkinleştir (varsayılan: false)

Örnek Talep

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-server-02",
    "plan_id": 1,
    "os_id": 5,
    "location": "us-west",
    "hostname": "web02.example.com",
    "backups_enabled": true
  }'

import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "name": "web-server-02",
    "plan_id": 1,
    "os_id": 5,
    "location": "us-west",
    "hostname": "web02.example.com",
    "backups_enabled": True
}

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

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'web-server-02',
    plan_id: 1,
    os_id: 5,
    location: 'us-west',
    hostname: 'web02.example.com',
    backups_enabled: true
  })
});

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

$data = [
    'name' => 'web-server-02',
    'plan_id' => 1,
    'os_id' => 5,
    'location' => 'us-west',
    'hostname' => 'web02.example.com',
    'backups_enabled' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$server = json_decode($response, true);
curl_close($ch);

Örnek Yanıt

{
  "id": 12347,
  "name": "web-server-02",
  "hostname": "web02.example.com",
  "status": "provisioning",
  "ip_address": null,
  "location": "us-west",
  "plan": {
    "id": 1,
    "name": "Standard VPS",
    "vcpus": 2,
    "memory": 4096,
    "storage": 80
  },
  "os": {
    "id": 5,
    "name": "Ubuntu 22.04 LTS"
  },
  "backups_enabled": true,
  "created_at": "2025-01-16T15:30:00Z",
  "updated_at": "2025-01-16T15:30:00Z",
  "message": "Server is being provisioned. This may take 2-5 minutes."
}

Yanıt Durum Kodları

201	Sunucu başarıyla oluşturuldu.
400	Hatalı İstek - Geçersiz parametreler
401	Yetkisiz - Geçersiz veya eksik API belirteci
402	Ödeme Gerekli - Yetersiz kredi

ELDE ETMEK /api/v1/servers/{server_id}/

Sunucu Ayrıntılarını Al

Belirli bir sunucu hakkında ayrıntılı bilgi alın.

Yol Parametreleri

Parametre	Tip	Gerekli	Tanım
`server_id`	tamsayı	Evet	Benzersiz sunucu kimliği

Örnek Talep

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

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

const serverId = 12345;
const response = await fetch(`https://admin.vps.org/api/v1/servers/${serverId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

Örnek Yanıt

{
  "id": 12345,
  "name": "web-server-01",
  "hostname": "web01.example.com",
  "status": "active",
  "ip_address": "203.0.113.10",
  "ipv6_address": "2001:0db8::1",
  "location": "us-west",
  "plan": {
    "id": 1,
    "name": "Standard VPS",
    "vcpus": 2,
    "memory": 4096,
    "storage": 80,
    "bandwidth": 2048
  },
  "os": {
    "id": 5,
    "name": "Ubuntu 22.04 LTS"
  },
  "backups_enabled": true,
  "resource_usage": {
    "cpu_percent": 23.5,
    "memory_used": 2048,
    "disk_used": 35,
    "bandwidth_used": 450
  },
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-16T15:45:00Z"
}

Yanıt Durum Kodları

200	Sunucu bilgileri başarıyla alındı.
401	Yetkisiz - Geçersiz veya eksik API belirteci
404	Bulunamadı - Sunucu mevcut değil.

KOYMAK /api/v1/servers/{server_id}/

Sunucuyu Güncelle

Sunucu yapılandırmasını güncelleyin. Tüm alanlar zorunludur.

Yol Parametreleri

Parameter	Type	Required	Description
`server_id`	integer	Yes	Benzersiz sunucu kimliği

İstek Gövdesi Parametreleri

Parametre	Tip	Gerekli	Tanım
`name`	sicim	Evet	Sunucu adı
`hostname`	sicim	Evet	Sunucu ana bilgisayar adı (FQDN)
`backups_enabled`	mantıksal	Evet	Otomatik yedeklemeleri etkinleştir/devre dışı bırak

Örnek Talep

cURL

Python

curl -X PUT "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-server-updated",
    "hostname": "web-updated.example.com",
    "backups_enabled": true
  }'

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "name": "web-server-updated",
    "hostname": "web-updated.example.com",
    "backups_enabled": True
}

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

Yanıt Durum Kodları

200	Sunucu başarıyla güncellendi.
400	Hatalı İstek - Geçersiz parametreler
404	Bulunamadı - Sunucu mevcut değil.

YAMA /api/v1/servers/{server_id}/

Sunucuyu Kısmen Güncelle

Belirtilen sunucu alanlarını güncelleyin. Yalnızca belirtilen alanlar güncellenecektir.

Örnek Talep

cURL

Python

curl -X PATCH "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "new-server-name"
  }'

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {"name": "new-server-name"}

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

SİLMEK /api/v1/servers/{server_id}/

Sunucuyu Sil

Sunucuyu kalıcı olarak silin. Bu işlem geri alınamaz.

Örnek Talep

cURL

Python

curl -X DELETE "https://admin.vps.org/api/v1/servers/12345/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

Yanıt Durum Kodları

204	Sunucu başarıyla silindi.
404	Bulunamadı - Sunucu mevcut değil.

POSTALAMAK /api/v1/servers/{server_id}/start/

Sunucuyu Başlat

Durdurulmuş bir sunucuyu yeniden başlatın.

Örnek Talep

cURL

Python

JavaScript

curl -X POST "https://admin.vps.org/api/v1/servers/12345/start/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/start/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

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

const serverId = 12345;
const response = await fetch(`https://admin.vps.org/api/v1/servers/${serverId}/start/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

Örnek Yanıt

{
  "status": "success",
  "message": "Server is starting",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "starting"
  }
}

Yanıt Durum Kodları

200	Sunucu başlatma komutu başarıyla gönderildi.
400	Hatalı İstek - Sunucu zaten çalışıyor.
404	Bulunamadı - Sunucu mevcut değil.

POSTALAMAK /api/v1/servers/{server_id}/stop/

Sunucuyu Durdur

Çalışmakta olan sunucuyu düzgün bir şekilde kapatın.

Örnek Talep

cURL

Python

curl -X POST "https://admin.vps.org/api/v1/servers/12345/stop/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/stop/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

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

Örnek Yanıt

{
  "status": "success",
  "message": "Server is stopping",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "stopping"
  }
}

POSTALAMAK /api/v1/servers/{server_id}/reboot/

Sunucuyu Yeniden Başlat

Çalışmakta olan bir sunucuyu sorunsuz bir şekilde yeniden başlatın.

Örnek Talep

cURL

Python

curl -X POST "https://admin.vps.org/api/v1/servers/12345/reboot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

server_id = 12345
url = f"https://admin.vps.org/api/v1/servers/{server_id}/reboot/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

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

Örnek Yanıt

{
  "status": "success",
  "message": "Server is rebooting",
  "server": {
    "id": 12345,
    "name": "web-server-01",
    "status": "rebooting"
  }
}

Yanıt Durum Kodları

200	Sunucu yeniden başlatma komutu başarıyla gönderildi.
400	Hatalı İstek - Sunucu çalışmıyor
404	Bulunamadı - Sunucu mevcut değil.

VPS.org API

Sunucular API'si

Tüm Sunucuları Listele

Sorgu Parametreleri

Örnek Talep

Örnek Yanıt

Yanıt Durum Kodları

Yeni Sunucu Oluştur

İstek Gövdesi Parametreleri

Örnek Talep

Örnek Yanıt

Yanıt Durum Kodları

Sunucu Ayrıntılarını Al

Yol Parametreleri

Örnek Talep

Örnek Yanıt

Yanıt Durum Kodları

Sunucuyu Güncelle

Yol Parametreleri

İstek Gövdesi Parametreleri

Örnek Talep

Yanıt Durum Kodları

Sunucuyu Kısmen Güncelle

Örnek Talep

Sunucuyu Sil

Örnek Talep

Yanıt Durum Kodları

Sunucuyu Başlat

Örnek Talep

Örnek Yanıt

Yanıt Durum Kodları

Sunucuyu Durdur

Örnek Talep

Örnek Yanıt

Sunucuyu Yeniden Başlat

Örnek Talep

Örnek Yanıt

Yanıt Durum Kodları