Cüzdan API'si

Kimliği doğrulanmış kullanıcı için kredi cüzdan bakiyesi.

Temel Yol

https://api.chainabit.com/api/v1/wallet

Kimlik Doğrulama (Authentication)

JWT Bearer token gereklidir. Kullanıcının ayrıca cüzdan erişimini içeren aktif bir yetkisi olmalıdır.

Çevre Değişkenleri

Bu sayfadaki herhangi bir örneği çalıştırmadan önce bu değişkenleri ayarlayın:

export BASE_URL="https://api.chainabit.com/api/v1"
export TOKEN="your-access-token"

POST /auth/login uç noktasını çağırarak erişim token'ınızı alın.

Uç Noktalar (Endpoints)

Yöntem	Yol	Açıklama	Kimlik Doğrulama	Hız Sınırı
GET	/wallet/me	Kredi cüzdan bakiyesini al	JWT + Yetki	--

---

GET /wallet/me

Abonelik kredileri ve satın alınan kredi paketleri dahil olmak üzere, kimliği doğrulanmış kullanıcının mevcut kredi cüzdan bakiyesini döndürür.

Kimlik Doğrulama: JWT Bearer token + aktif cüzdan yetkisi gereklidir.

İstek (Request)

Yol veya sorgu parametresi yok.

Yanıt (Response)

Yanıt Örneği

{
  "data": {
    "balance": {
      "total": 1158,
      "subscriptionCredits": 658,
      "purchasedCredits": 500
    },
    "subscription": {
      "planCode": "pro-monthly",
      "creditUnits": 1000,
      "used": 342,
      "remaining": 658,
      "resetsAt": "2026-04-01T00:00:00.000Z"
    }
  },
  "meta": null,
  "error": null
}

Yanıt Alanları

Alan	Tür	Açıklama
balance.total	number	Toplam kullanılabilir krediler (abonelik + satın alınan)
balance.subscriptionCredits	number	Mevcut abonelik döneminden kalan krediler
balance.purchasedCredits	number	Tek seferlik kredi paketi alımlarından gelen krediler
subscription.planCode	string	Aktif abonelik planı kodu
subscription.creditUnits	number	Fatura döngüsü başına tahsis edilen toplam kredi
subscription.used	number	Mevcut dönemde tüketilen krediler
subscription.remaining	number	Mevcut dönemde kalan krediler
subscription.resetsAt	string	Abonelik kredilerinin sıfırlandığı ISO 8601 zaman damgası

Kod Örneği

cURL

curl https://api.chainabit.com/api/v1/wallet/me \
  -H "Authorization: Bearer $TOKEN"

JavaScript

const response = await fetch(`${BASE_URL}/wallet/me`, {
  headers: {
    'Authorization': `Bearer ${TOKEN}`,
  },
});
const data = await response.json();

Python

import requests

response = requests.get(
    f"{BASE_URL}/wallet/me",
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = response.json()

---

Notlar (Notes)

• Cüzdan bakiyesi, abonelik kredilerini ve satın alınan kredileri birleştirir. Abonelik kredileri her fatura döngüsünün başında sıfırlanır. Satın alınan kredilerin süresi dolmaz.
• Kullanıcının aktif bir aboneliği yoksa, subscription alanı null olacak ve yalnızca purchasedCredits mevcut olacaktır.
• Bu uç nokta aktif bir yetki gerektirir. Cüzdan erişimi olmayan ücretsiz bir plandaki kullanıcılar 403 Forbidden yanıtı alacaktır.