Anahtar oluşturma
- Hesap → API anahtarları sayfasını açın (sahip ya da yönetici rolü gerekir; askıdaki hesap yeni anahtar oluşturamaz).
- 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. - 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.

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ç | Kapsam | Not |
|---|---|---|
GET /api/v1/me | read | organizasyon, bakiye, kapsamlar; askıdaki hesap da okuyabilir |
GET /api/v1/servers | read | dedicated hizmetler ve bulut sunucular; askıdaki hesap giremez |
GET /api/v1/plans | anahtar gerekmez | bulut planları ve saatlik fiyatlar |
GET /api/v1/stock | anahtar gerekmez | canlı 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: 1760800000X-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ı
| Kod | Gövde | Anlamı |
|---|---|---|
| 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.
