Open API · فقط‌خواندنی

مصرف و انقضای کلید API خود را به‌صورت برنامه‌ای استعلام کنید

یک توکن دسترسی فقط‌خواندنی در داشبورد خود تولید کنید و با یک دستور، تاریخ انقضا، مصرف روزانه و سهمیه هر کلید API فعال را استعلام کنید — سپس آن را به اسکریپت‌ها، داشبوردها و هشدارهای خود متصل کنید.

فقط‌خواندنی، هرگز به موجودی دست نمی‌زند تولید / بازنشانی با یک کلیک پاسخ JSON، آسان برای یکپارچه‌سازی

چه چیزی را می‌توانید استعلام کنید

یک توکن، شاخص‌های عملیاتی اصلی کلیدهای API شما را پوشش می‌دهد

تاریخ انقضا

تاریخ انقضای دقیق هر کلید API فعال، تا بتوانید تمدیدها را از پیش برنامه‌ریزی کنید و از قطعی سرویس جلوگیری کنید.

مصرف روزانه و ماهانه

هزینه و تعداد درخواست امروز، به‌همراه سهمیه مصرف‌شده / سقف این ماه و میزان استفاده، در یک نگاه.

توکن خودسرویس

توکن را در داشبورد خود تولید، بازنشانی یا ابطال کنید؛ سرور فقط یک هش ذخیره می‌کند و متن ساده را فقط یک بار نمایش می‌دهد.

سه مرحله برای یکپارچه‌سازی

از تولید توکن تا یک استعلام کارا در چند دقیقه

1

تولید توکن در داشبورد

وارد شوید، کارت Open API را باز کنید، روی تولید کلیک کنید و یک توکن دسترسی qot_ دریافت کنید (آن را ایمن نگه دارید).

2

API را با توکن فراخوانی کنید

Authorization: Bearer qot_... را اضافه کنید و GET /api/v1/openapi/keys مصرف شما را به‌صورت JSON برمی‌گرداند.

3

یکپارچه‌سازی با ابزارهای شما

پاسخ را به اسکریپت‌ها، داشبوردهای پایش، هشدارهای انقضا یا خطوط لوله CI برای عملیات خودکار متصل کنید.

با یک دستور شروع کنید

HTTP ساده + توکن Bearer — آن را از هر زبانی فراخوانی کنید

این نقطه پایانی، JSON ساخت‌یافته‌ای شامل نام هر کلید فعال، تاریخ انقضا، مصرف امروز و سهمیه ماهانه برمی‌گرداند — آماده برای تجزیه.

  • •فقط‌خواندنی: فقط می‌تواند کلیدهای API حساب کاربری خودتان را استعلام کند — هرگز کلیدی ایجاد یا تغییر نمی‌دهد و از موجودی خرج نمی‌کند.
  • •کش داخلی و محدودیت نرخ درخواست، آن را سریع و سبک از نظر منابع نگه می‌دارد.
# درخواست
curl -H "Authorization: Bearer qot_xxx" \
  https://qcode.cc/api/v1/openapi/keys

پاسخ نمونه

{
  "ok": true,
  "data": {
    "keys": [{
      "name": "Pro unlimited/day",
      "is_active": true,
      "expires_at_display": "2026/08/22 21:35",
      "current_daily_cost": 42.04,
      "current_requests": 115,
      "monthly_cost_used": 1683.29,
      "monthly_cost_limit": 4000.0
    }],
    "active_api_keys": 1
  }
}

برای کلیدهای Ultimate، monthly_cost_used / monthly_cost_limit چرخه 30 روزه جاری را پوشش می‌دهند (مصرف‌شده در این چرخه / سهمیه ماهانه) و در هر چرخه از نو شروع می‌شوند؛ کلیدهای Ultimate قدیمی‌تر که بازنشانی ماهانه ندارند، همچنان مصرف کل / بودجه کل را گزارش می‌کنند.

نقاط پایانی

همه درخواست‌های GET فقط‌خواندنی‌اند و با توکن Bearer احراز هویت می‌شوند.

نقطه پایانی توضیحات
GET /api/v1/openapi/keysفهرست همه کلیدهای API فعال شما همراه با تاریخ انقضا، مصرف امروز، سهمیه ماهانه و میزان استفاده.
GET /api/v1/openapi/meخلاصه در سطح حساب کاربری: تعداد کلیدهای فعال و هزینه کل امروز.
GET /api/v1/openapiخودتوصیفی: فهرست نقاط پایانی و اطلاعات مصرف را برمی‌گرداند؛ برای بررسی‌های زنده‌بودن مفید است.

موارد استفاده رایج

داده‌های مصرف را به گردش کار موجود خود متصل کنید

هشدارهای انقضا

تاریخ انقضا را طبق یک زمان‌بندی بررسی کنید و پیش از منقضی شدن کلیدها، یادآورهای ایمیل / IM / Telegram را به‌صورت خودکار ارسال کنید.

داشبورد مصرف

هزینه روزانه و میزان استفاده از سهمیه را به Grafana، صفحه‌گسترده‌ها یا پنل خودتان بدهید.

پایش چند کلید

وقتی یک تیم چند کلید دارد، وضعیت سلامت و سهمیه همه آن‌ها را یک‌جا دریافت کنید.

CI / خودکارسازی

پیش از اجرای کارهای پرهزینه هوش مصنوعی در خط لوله خود، بررسی کنید که یک کلید هنوز معتبر است و سهمیه دارد.

امنیت از مرحله طراحی

توکن یک رشته تصادفی با آنتروپی بالا است؛ سرور فقط یک هش HMAC ذخیره می‌کند و متن ساده را یک بار آشکار می‌کند. این توکن کاملاً فقط‌خواندنی است — نمی‌تواند کلیدها را ایجاد یا مدیریت کند یا به موجودی شما دست بزند — و محدودیت‌های نرخ درخواست داخلی به‌ازای هر دقیقه / هر روز دارد. اگر افشا شود، آن را با یک کلیک بازنشانی کنید و توکن قدیمی فوراً از کار می‌افتد.

پرسش‌های متداول

چگونه می‌توانید توکن دسترسی دریافت کنید؟

به QCode وارد شوید، کارت Open API را در داشبورد خود باز کنید و روی تولید کلیک کنید. توکن متن ساده فقط یک بار نمایش داده می‌شود، پس فوراً آن را کپی کنید؛ در صورت گم شدن، هر زمان می‌توانید آن را بازنشانی کنید.

آیا توکن ایمن است؟

بله. این توکن فقط‌خواندنی است و فقط می‌تواند مصرف و انقضای کلید API حساب کاربری خودتان را استعلام کند — نمی‌تواند کلیدها را ایجاد یا تغییر دهد یا از موجودی خرج کند. سرور فقط یک هش ذخیره می‌کند و بازنشانی با یک کلیک، توکن افشا‌شده را باطل می‌کند.

آیا محدودیت نرخ درخواست وجود دارد؟

بله. هر توکن محدودیت فراخوانی به‌ازای هر دقیقه و هر روز دارد و نتایج برای چند ثانیه کش می‌شوند — برای درخواست‌های دوره‌ای و پایش منظم کافی است. اگر به سهمیه بالاتری نیاز دارید، با پشتیبانی تماس بگیرید.

همین حالا مصرف خود را استعلام کنید

وارد شوید، توکن دسترسی فقط‌خواندنی خود را تولید کنید و در چند دقیقه هشدارهای انقضا و داشبوردهای مصرف را راه‌اندازی کنید.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط