Kredi Bakiyesi
Kullanımı yönetmek ve iş başarısızlıklarını önlemek için mevcut kullanılabilir kredi bakiyenizi sorgulayın.
GET
/api/v1/balanceHızlı Uygulama
curl -X GET https://api.srtgen.com/api/v1/balance \ -H "x-api-key: <YOUR_API_KEY>"
GEThttps://api.srtgen.com/api/v1/balance
Bu uç nokta, hem aylık abonelik ödeneklerinizi hem de satın aldığınız tüm ekstra yükleme kredilerini içeren toplam kullanılabilir bakiyeyi döndürür.
Yanıt Yapısı
| Parametre | Tür | Gerekli |
|---|---|---|
| Kimlik ve Bağlam | ||
user | Nesne | Kimliği doğrulanmış kullanıcı hakkında temel bilgiler. |
user.name | Tür | Kullanıcının görünen adı. |
user.email | Tür | Kayıtlı e-posta adresi. |
| Kredi Bakiyesi Dağılımı | ||
credits | Nesne | Ayrıntılı kredi bakiyesi dökümü. |
credits.totalBalance | Number | Tüm kullanılabilir kredilerin toplamı (Ödenekler + Ekstra). |
credits.extraCredits | Number | Kalıcı yükleme kredileri. |
credits.plans | Array | Aktif abonelik planlarının listesi. |
plans[].name | Tür | Planın görünen adı (örn. 'Pro Plan'). |
plans[].status | Tür | Abonelik durumu (active, past_due). |
plans[].balance | Number | Bu belirli döngüde kalan krediler. |
| Bulut Depolama Kullanımı | ||
storage | Nesne | Bulut depolama kullanım istatistikleri. |
storage.usage | Number | Bayt cinsinden mevcut depolama kullanımı. |
storage.limit | Number | Planınıza bağlı olarak bayt cinsinden maksimum depolama sınırı. |
storage.formattedUsage | Tür | Okunabilir kullanım (örn. '200 MB'). |
storage.formattedLimit | Tür | Okunabilir sınır (örn. '10 GB'). |
Örnek Yanıt: 200 OK
{ "success": true, "user": { "name": "Alex Rivera", "email": "[email protected]" }, "credits": { "totalBalance": 1250, "totalMonthlyCredits": 1000, "extraCredits": 250, "plans": [ { "id": "starter", "name": "Starter Plan", "status": "active", "balance": 1000, "total": 1000, "resetTime": "2026-04-29T17:48:46.000Z" } ] }, "storage": { "usage": 209715200, "limit": 10737418240, "formattedUsage": "200 MB", "formattedLimit": "10 GB" }, "updatedAt": "2026-03-29T17:48:46.000Z" }
Hatalar
| Durum | Hata Kodu | Açıklama |
|---|---|---|
| 401 | unauthorized | API anahtarı eksik veya geçersiz. |
| 500 | server_error | Beklenmedik bir dahili hata oluştu. |
bu sayfa yardımcı oldu mu?