Plan, limit, kullanım ve abonelik durumunu getirir
GET/api/v1/billing
Yalnız okunur: satın alma, plan değişikliği, iptal, kart ve ek paket işlemleri Creem ödeme sayfasında kalır (manage_url). Ödeme sağlayıcısı kimlikleri dönmez. Yönetici yetkisi gerekir. Kapsam: organization:read.
- Kapsam
organization:read- SDK metodu
- getBilling · get_billing
- MCP aracı
getBillingsalt okunur
Örnek istek
curl -X GET "https://hiboty.com/api/v1/billing" \
-H "Authorization: Bearer $HIBOTY_API_KEY"Örnek yanıt (200)
JSON
{
"data": {
"plan": "string",
"limits": {
"bots": 1,
"monthly_messages": 1,
"ai_replies": 1,
"seats": 1,
"workspaces": 1,
"campaigns": true,
"api": true,
"mini_apps": true,
"storage_mb": 1
},
"usage": {
"messages": 1,
"ai_replies": 1,
"bots": 1,
"seats": 1,
"storage_bytes": 1
},
"subscription": {
"status": "string",
"plan": "string",
"period": "string",
"current_period_end": "2026-11-06T09:00:00.000Z",
"canceled_at": "2026-11-06T09:00:00.000Z"
},
"ai_extra_credits": 1,
"price": {
"currency": "USD",
"monthly_amount_cents": 1,
"yearly_amount_cents": 1
},
"manage_url": "https://example.com/a.png"
}
}Olası hatalar
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.