Hızlı başlangıç

1. Base URL

https://api.getdraeva.com

Tüm kararlı endpoint'ler /v1 ile sürümlenir ve servis önekinden sonra gelir.

2. API anahtarı

DRAEVA API erişimi şu anda yönetilen erişim modeliyle sağlanır. API erişimi ve destek sayfasındaki bilgilerle erişim talebi oluşturun. Talebinizde ihtiyacınız olan servis ve scope'ları belirtin. Müşteriye anahtar teslim yöntemi henüz netleşmemiştir; destekle netleştirin.

Anahtarı bir server-side environment variable içinde saklayın:

DRAEVA_API_KEY=YOUR_DRAEVA_API_KEY

Değeri kaynak koda, .env.example dosyasına, mobil pakete veya browser'a açık değişkenlere yazmayın.

3. İlk anahtarlı istek

Aşağıdaki örnek, bir kıyafet görselinin arka planını kaldırır. Üç servis de canlıdır; ayrı staging/test ortamı yoktur. Fiyatlandırma henüz belirlenmemiştir ve deneme isteklerinin ücretsiz olduğu varsayılmamalıdır. Çağrı yapmadan önce erişim ve ticari koşulları destekle netleştirin; kişisel veri içermeyen bir fixture kullanın:

curl -X POST https://api.getdraeva.com/bg/v1/background-removals \
  -H "Authorization: Bearer YOUR_DRAEVA_API_KEY" \
  -F "image=@garment.png" \
  --output garment-transparent.png

Başarılı yanıt ham PNG'dir:

HTTP/1.1 200 OK
Content-Type: image/png
X-Request-Id: 01J...
RateLimit-Limit: 30
RateLimit-Remaining: 29

4. Anahtarsız keşif endpoint'leri

Aşağıdaki sözlük endpoint'leri anahtarsız olarak belgelenmiştir; anahtarsız erişim bir fiyatlandırma taahhüdü değildir:

curl https://api.getdraeva.com/look/v1/params
curl https://api.getdraeva.com/taxonomy/v1/options

GET /look/v1/meta anahtarlıdır ve look-engine:read gerektirir.

5. İstemci davranışı

• Her çağrı için makul bir timeout belirleyin.
• 429 yanıtında Retry-After değerine uyun.
• 502 ve 503 yanıtlarını sınırlı exponential backoff ile tekrar deneyin.
• 400, 401, 403, 413 ve 415 hatalarını otomatik tekrar denemeyin.
• Hata type ve X-Request-Id değerlerini güvenli loglayın; API anahtarını ve görsel byte'larını loglamayın.

Sonraki adımlar

• API erişimi ve destek: support.md
• Anahtar ve güvenlik: authentication.md
• Yetkiler: scopes.md
• Hatalar: errors.md
• Canlıya çıkış: guides/production-checklist.md