API başvurusu

Abonelik

Bu gruptaki 1 uç.

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.