turknode.cloud/docs/api

API

Paneldeki her işlemin bir endpoint'i var. Bir token oluşturun, JSON gönderin, JSON alın.

Temel bilgiler

Base URL: https://api.turknode.cloud/v1
Kimlik doğrulama: Authorization: Bearer YOUR_TOKEN — token'ları panelde Developer → API Keys altında oluşturun
Token'lar: Hesap başına en fazla 10, istediğiniz zaman iptal edilebilir
İstek sınırı: Hesap başına dakikada 120 istek
Faturalandırma: API üzerinden sipariş edilen sunucular cüzdanınızdan ödenir
Header'lar: Accept: application/json ve kendi User-Agent değerinizi gönderin

Planları listeleyin

Sipariş verirken bir planın id değerini kullanın.

curl https://api.turknode.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

Sunucu oluşturun

Root şifresi 8–12 karakter olmalı; bir küçük harf, bir büyük harf, bir rakam ve ! # + $ * - karakterlerinden birini içermelidir.

curl -X POST https://api.turknode.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Endpoint'ler

Hesap ve katalog

GET	/v1/account	Hesabınız, bakiyeniz ve bayi indiriminiz
GET	/v1/plans	Satıştaki planlar ve fiyatları
GET	/v1/os	Kurabileceğiniz işletim sistemleri

Sunucular

GET	/v1/servers	Sunucularınızı listeler
POST	/v1/servers	Sunucu oluşturur
GET	/v1/servers/{id}	Sunucu ayrıntıları
PATCH	/v1/servers/{id}	Sunucuyu yeniden adlandırır
DELETE	/v1/servers/{id}	Sunucuyu iptal eder; kullanılmayan süre cüzdana iade edilir
POST	/v1/servers/{id}/start	Başlat
POST	/v1/servers/{id}/stop	Durdur
POST	/v1/servers/{id}/restart	Yeniden başlat
POST	/v1/servers/{id}/rebuild	Başka bir sistemle yeniden kurar
POST	/v1/servers/{id}/reset-password	Yeni root şifresi belirler
POST	/v1/servers/{id}/request-ip-change	IP değişikliği talep eder
GET	/v1/servers/{id}/upgrade-options	Sunucunun yükseltilebileceği planlar
POST	/v1/servers/{id}/upgrade	Daha büyük bir plana yükseltir
POST	/v1/servers/{id}/vnc	Tarayıcı konsol oturumu açar

Cüzdan ve faturalar

GET	/v1/wallet	Cüzdan bakiyesi
GET	/v1/wallet/transactions	Cüzdan hareketleri
GET	/v1/invoices	Faturaları listeler
GET	/v1/invoices/{id}	Fatura ayrıntıları

Destek talepleri

GET	/v1/tickets	Talepleri listeler
POST	/v1/tickets	Talep açar
GET	/v1/tickets/{id}	Mesajlarıyla birlikte bir talep
POST	/v1/tickets/{id}/reply	Talebe yanıt verir
POST	/v1/tickets/{id}/close	Talebi kapatır

Hatalar

401 Unauthenticated

Token yanlış ya da iptal edilmiş. Developer → API Keys altında yeni bir tane oluşturun.

403 ve 1010 hatası

HTTP kütüphaneniz güvenlik duvarımızın engellediği varsayılan bir User-Agent gönderiyor (Python urllib, Perl LWP). Kendi User-Agent header'ınızı ayarlayın ya da requests / httpx kullanın.

422 Unprocessable

Bir alan geçersiz; JSON gövdesi her alanı ve nedenini listeler.

429 Too Many Requests

Dakikada 120 isteği aştınız. Bekleyip tekrar deneyin.

WHMCS'ten mi satıyorsunuz?

Ücretsiz modülümüz bu API'yi sizin yerinize kullanır.

WHMCS modülü