API Referansı

Hata İşleme

Standart hata kodları, hız sınırı başlıkları ve sorun giderme.

Son güncelleme: 28 Mayıs 2026

Hata Yönetimi

Tüm hata yanıtları, bir hata kodu ve insanlar tarafından okunabilir mesaj içeren tutarlı bir format izler:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Description of what went wrong"
  }
}

HTTP Status	Code	Description
400	VALIDATION_ERROR	Geçersiz veya eksik istek parametreleri
401	UNAUTHORIZED	Eksik veya geçersiz API anahtarı
402	PAYMENT_REQUIRED	Yetersiz kredi
403	FORBIDDEN	API erişimi Business planı gerektirir veya işleme izin verilmez
403	LIMIT_EXCEEDED	Plan sınırlarına ulaşıldı (projeler, derlemeler vb.)
404	NOT_FOUND	Kaynak bulunamadı veya erişilemiyor
409	CONFLICT	Kaynak çakışması (dağıtım devam ediyor, alan adı alınmış vb.)
429	RATE_LIMITED	Çok fazla istek — hız sınırı başlıklarını kontrol edin
500	INTERNAL_ERROR	Sunucu hatası — lütfen yeniden deneyin veya destek ile iletişime geçin

Her yanıt bu başlıkları içerir:

X-RateLimit-Remaining — Mevcut pencerede kalan istek sayısı
X-RateLimit-Reset — Hız sınırı penceresinin sıfırlanmasına kalan saniye sayısı

429 yanıtı aldığınızda, yeniden denemeden önceX-RateLimit-Reset ile belirtilen saniye sayısı kadar bekleyin.

Kredi tüketen API işlemleri:

Yöneticiler kredi ücretinden muaftır.

401 Unauthorized — API anahtarınızın flp_ ile başladığını ve Bearer token olarak dahil edildiğini kontrol edin
403 Forbidden — Hesabınızın aktif bir Business aboneliğine sahip olduğunu doğrulayın
409 Conflict on deploy — Mevcut dağıtımın tamamlanmasını bekleyin veya önce iptal edin
Alt alan adı hataları — Alt alan adları küçük harf olmalı, 3-63 karakter içermeli ve yalnızca harf, rakam ve kısa çizgi içermelidir