Hata Kodları ve Durum Referansı

Smart Money API hata kodları, HTTP durum kodları ve sorun giderme adımları için kapsamlı rehber. Hata yanıtlarını anlayın ve entegrasyon sorunlarını hızlıca çözün.

2xx Başarı Kodları

Başarı yanıtları, isteğin başarıyla işlendiğini gösterir.

Kod	Durum	Anlam
200	OK	İstek başarılı. Yanıt gövdesi istenen verileri içerir.
201	Created	Kaynak başarıyla oluşturuldu. Yanıt yeni kaynağı içerir.
204	No Content	İstek başarılı ancak döndürülecek içerik yok (örn., DELETE).

Örnek 200 Yanıtı

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx İstemci Hata Kodları

İstemci hataları, isteğin hatalı veya geçersiz olduğunu gösterir. İsteğinizi düzeltip tekrar deneyin.

Kod	Durum	Sebep
400	Bad Request	Hatalı istek sözdizimi. Sorgu parametrelerini, başlıkları ve istek gövdesini kontrol edin.
401	Unauthorized	Eksik veya geçersiz kimlik doğrulama bilgileri. API anahtarınızı veya JWT token'ınızı kontrol edin.
402	Payment Required	Abonelik ödemeniz başarısız oldu. Hesabınızdaki fatura bilgilerini güncelleyin.
403	Forbidden	Kimlik doğrulandı ancak bu kaynak için yetkiniz yok. Planınız bu özelliği içermiyor.
404	Not Found	Kaynak mevcut değil. Uç nokta URL'sini ve parametreleri kontrol edin.
429	Too Many Requests	Oran sınırı aşıldı. Tekrar denemeden önce bekleyin. Retry-After başlığını kontrol edin.
422	Unprocessable Entity	Doğrulama başarısız. İstek parametreleri geçersiz veya gerekli alanlar eksik.

Kimlik Doğrulama Hata Örnekleri

Eksik API Anahtarı (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Kimlik doğrulama bilgileri sağlanmadı.",
    "resolution": "Authorization başlığına API anahtarınızı ekleyin: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Geçersiz API Anahtarı (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Geçersiz veya süresi dolmuş API anahtarı.",
    "resolution": "https://smartmoneyapi.com/console adresinden yeni bir API anahtarı oluşturun"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Oran Sınırlama (429)

API kotanızı aştığınızda, sunucu 429 Too Many Requests döndürür. Oran sınırı bilgileri için yanıt başlıklarını kontrol edin:

HTTP Başlıkları

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Oran Sınırı Hata Yanıtı

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Günlük API istek limiti (10) aşıldı.",
    "resolution": "Trader ($29/ay, 400 istek/gün) veya Pro ($79/ay, 4,000 istek/gün) planına yükseltin.",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Doğrulama Hataları (422)

Doğrulama hataları, istek parametreleriniz geçersiz veya gerekli alanlar eksik olduğunda oluşur.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "İstek doğrulaması başarısız oldu.",
    "details": [
      {
        "field": "symbol",
        "error": "Geçersiz işlem çifti. Beklenen format: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Pozitif bir sayı olmalıdır"
      }
    ],
    "resolution": "Doğrulama hatalarını düzeltip tekrar deneyin."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx Sunucu Hata Kodları

Sunucu hataları bizim tarafımızda bir sorun olduğunu gösterir. Bunlar geçicidir ve genellikle hızlıca çözülür. Üstel geri çekme mantığıyla tekrar deneyin.

Kod	Durum	Eylem
500	Internal Error	Beklenmeyen sunucu hatası. Üstel geri çekmeyle tekrar deneyin.
502	Bad Gateway	Geçici servis kesintisi. Birkaç saniye sonra tekrar deneyin.
503	Service Unavailable	Bakım veya geçici kesinti. Durum sayfasını kontrol edin. Retry-After aralığından sonra tekrar deneyin.
504	Gateway Timeout	İstek çok uzun sürdü. Sunucu işlemiş olabilir. İdempotency'yi kontrol edin.

Sunucu Hata Örneği (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Bakım nedeniyle servis geçici olarak kullanılamıyor.",
    "resolution": "Lütfen 5 dakika sonra tekrar deneyin. Durumu https://status.smartmoneyapi.com adresinden takip edin"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Sorun Giderme Rehberi

401 Unauthorized - Geçersiz API Anahtarı

Sorun: API anahtarı olmasına rağmen 401 hataları alınıyor.

Çözümler:

API anahtarının "Bearer" önekiyle Authorization başlığına eklendiğini doğrulayın
API anahtarınızın süresinin dolmadığını veya iptal edilmediğini kontrol edin
Doğru anahtarı kullandığınızdan emin olun (production, staging veya development)
Mevcut anahtar kaybolduysa konsolunuzdan yeni bir API anahtarı oluşturun

403 Forbidden - Özellik Mevcut Değil

Sorun: Bazı uç noktalarda 403 hataları alınıyor.

Çözümler:

API seviyenizi kontrol edin. Bazı uç noktalar Trader veya Pro planları gerektirir
Premium özelliklere erişmek için /pricing.html adresinden planınızı yükseltin
API anahtarının gerekli izinlere sahip olduğunu doğrulayın
Erişiminiz olması gerektiğini düşünüyorsanız destek ekibiyle iletişime geçin

429 Too Many Requests - Oran Sınırlı

Sorun: 429 hataları alınıyor ve oran sınırlaması uygulanıyor.

Çözümler:

Üstel geri çekme mantığıyla tekrar deneyin (1s, 2s, 4s bekleyin vb.)
Yinelenen API çağrılarından kaçınmak için yanıtları önbelleğe alın
Gerçek zamanlı veri için REST uç noktalarını sorgulamak yerine WebSocket kullanın
Daha yüksek kotalar için planınızı yükseltin (Trader 1,000/gün, Pro 5,000/gün)
Mümkün olduğunda birden fazla sorguyu tek bir istekte birleştirin

400 Bad Request - Geçersiz Parametreler

Sorun: Hatalı isteklerle 400 hataları alınıyor.

Çözümler:

Gerekli ve isteğe bağlı parametreler için API dokümantasyonunu kontrol edin
Parametre türlerini doğrulayın (string vs number, array vs object)
JSON'ın geçerli ve doğru biçimlendirildiğinden emin olun
Doğru uç nokta URL'lerini ve path parametrelerini kullanın
Sorgu parametre adlarında yazım hatalarını kontrol edin

5xx Sunucu Hataları - Geçici Kesintiler

Sorun: 500, 502, 503 veya 504 hataları alınıyor.

Çözümler:

Hizmet durumunu https://status.smartmoneyapi.com adresinden kontrol edin
Üstel geri çekme ile otomatik yeniden deneme uygulayın (maksimum 5-10 deneme)
503 hatalarında yeniden denemeden önce 30-60 saniye bekleyin
Yeniden deneme zamanlamasını belirlemek için Retry-After başlığını kullanın
Olay bildirimleri için durum sayfasına abone olun

Hata Yanıt Formatı

Tüm hata yanıtları tutarlı bir formatta gelir:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "İnsan tarafından okunabilir hata mesajı",
    "details": {...},
    "resolution": "Sorunu çözmek için adımlar"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Daha Fazla Yardım Mı Lazım?

API dokümantasyonumuzu kontrol edin veya hata kodunuzu ve istek detaylarınızı destek ekibimize iletin.

API Referansı

Destek Alın

Sorularınız mı var? Dokümantasyonumuzu kontrol edin veya destek ekibimize ulaşın.

Konsolu Aç