İçeriğe atla
Konsol

API anahtarları

API anahtarıyla hesabınızı ve sunucularınızı kendi betiklerinizden, CI işlerinizden ya da uygulamalarınızdan okuyabilirsiniz. Anahtar organizasyona aittir; onu oluşturan kişi ekipten ayrılsa da çalışmaya devam eder.

Güncelleme: 20 Ekim 2026 · 2 dk okuma

Anahtar oluşturma

  1. Hesap → API anahtarları sayfasını açın (sahip ya da yönetici rolü gerekir; askıdaki hesap yeni anahtar oluşturamaz).
  2. Bir ad verin (ör. ci-deploy) ve süre seçin: 30, 90, 365 gün ya da süresiz. Süre dolunca anahtar kendiliğinden geçersiz olur.
  3. Anahtar oluştur ile tam anahtar yalnız bir kez gösterilir; dor_ ile başlar. Kopyalayıp gizli deponuza (CI secret, parola yöneticisi) koyun. Listede sonradan yalnız ilk 12 karakteri, son kullanım ve bitiş tarihi görünür.
API anahtarları sayfası: ad ve süre alanı, anahtar listesi, curl örneği
API anahtarları sayfası: ad ve süre alanı, anahtar listesi, curl örneği

Kapsam

Her anahtarın kapsamı vardır: read yalnız okuma uçları, write yazma uçları (okumayı da kapsar). Konsoldan oluşturulan anahtarlar okuma ve yazma kapsamıyla gelir; kapsam listede görünür. Yazma uçları eklendikçe burada duyurulur.

Kullanım

Anahtarı Authorization: Bearer başlığıyla gönderin:

curl https://dor.net/api/v1/me \
  -H "Authorization: Bearer dor_XXXXXXXX"

Örnek yanıt:

{
  "organization": { "id": "…", "name": "Ornek A.Ş.", "status": "active" },
  "balance": { "amount": 125.5, "currency": "EUR" },
  "scopes": ["read", "write"]
}

Sunucular (dedicated ve bulut tek listede):

curl https://dor.net/api/v1/servers \
  -H "Authorization: Bearer dor_XXXXXXXX"
{
  "items": [
    { "id": "d-…", "kind": "dedicated", "name": "db-1", "status": "active", "power": "on", "ipv4": "203.0.113.10", "os": "Ubuntu 24.04", "hardware": { "model": "…", "cpu": "…", "cores": 20, "threads": 40, "memoryGb": 256, "disks": "…" } },
    { "id": "…", "kind": "cloud", "name": "app-1", "status": "running", "plan": "c16", "memoryGb": 16, "vcpu": 4 }
  ]
}

Uç noktalar

UçKapsamNot
GET /api/v1/mereadorganizasyon, bakiye, kapsamlar; askıdaki hesap da okuyabilir
GET /api/v1/serversreaddedicated hizmetler ve bulut sunucular; askıdaki hesap giremez
GET /api/v1/plansanahtar gerekmezbulut planları ve saatlik fiyatlar
GET /api/v1/stockanahtar gerekmezcanlı dedicated stok; ?minMemory=64&disk=nvme süzgeçleri

Hız sınırı

Her anahtar saatte 600 istek yapabilir. Her yanıtta sınır başlıkları döner:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 597
X-RateLimit-Reset: 1760800000

X-RateLimit-Reset pencerenin kapanacağı anın Unix zaman damgasıdır. Sınır aşıldığında 429 ve Retry-After (saniye) döner; o süre dolmadan yeni istek göndermeyin.

Hata kodları

KodGövdeAnlamı
401{"error":"unauthorized"}anahtar yok, yanlış, iptal edilmiş ya da süresi dolmuş
403{"error":"forbidden_scope"}anahtarın kapsamı bu uç için yetersiz
403{"error":"org_suspended"}hesap askıda; bakiye yükleyip yeniden deneyin
429{"error":"rate_limited"}hız sınırı; Retry-After başlığına bakın

İptal ve güvenlik

  • Anahtarı listeden İptal et ile anında geçersiz kılarsınız; geri alınamaz, yenisini oluşturursunuz.
  • Anahtar sızdıysa önce iptal edin, sonra güvenlik sayfasından parolanızı değiştirin.
  • Anahtarı URL'ye, günlüklere ya da istemci tarafı koda koymayın; sunucu tarafında ortam değişkeninde tutun.
  • Her anahtarın oluşturulması ve iptali denetim kaydına yazılır.

← Tüm rehberler

Aradığınızı bulamadınız mı?

Konsoldan destek talebi açın; bir iş günü içinde dönüyoruz. Satış soruları için sales@dor.net.