صورت‌حساب و اعتبارها
نسخهٔ API 2026-10-virile-dragon
دو روش پرداخت
هر کلاینت به یکی از دو روش صورت‌حساب می‌شود و حالت آن هنگام ساختنش ثابت می‌شود. کلاینت allowance از سهمیهٔ طرح مالک خود مصرف می‌کند، همان سهمیه‌ای که برنامه‌های شما مصرف می‌کنند، و هرگز از هیچ کارتی برداشت نمی‌کند. کلاینت metered از هیچ سهمیه‌ای مصرف نمی‌کند: هر فراخوانی آن اعتبار هزینه دارد که از کارت اشتراک صورت‌حساب مصرفی شما برداشت می‌شود. فراخوانی‌ای که برنامه با توکنی از کد مجوز از طرف کاربر دیگری انجام می‌دهد، همیشه از سهمیهٔ همان کاربر مصرف می‌کند، فارغ از حالت کلاینت.
اعتبار برای هر فراخوانی
هر فراخوانی کلاینت metered به اندازهٔ ارزش دامنهٔ دسترسی‌اش اعتبار هزینه دارد که در جدول زیر فهرست شده است؛ دامنه‌ای که ارزش آن 0 اعتبار است هزینه‌ای ندارد. unitsی که GET /v1/usage گزارش می‌دهد با همین وزن‌ها به اعتبار تبدیل می‌شود. هر فراخوانی با وزن‌هایی صورت‌حساب می‌شود که در روز انجام آن معتبرند، فارغ از نسخه‌ای که کلاینت به آن سنجاق شده است: جدول موجود در مرجع یک نسخهٔ قدیمی‌تر وزن‌های زمان انتشار آن نسخه را ثبت کرده است، نه هزینهٔ امروز یک فراخوانی را.
vocab:generate | ساخت فهرست واژگان. | ساخت فهرست واژگان |
lesson_plans:read | خواندن طرح‌های درس خود و اتصال دوباره به پیشرفت آن‌ها. | دریافت طرح درساتصال دوباره به طرح درس |
lesson_plans:write | ساخت طرح درس. | ساخت طرح درس |
tutor:converse | گفتگو با مربی. به اشتراک پولی نیاز دارد. | ارسال یک نوبت به مربی |
usage:read | مشاهدهٔ سهمیهٔ باقی‌مانده، یا مصرف این ماه یک کلاینت `metered`. | دریافت سهمیهٔ باقی‌مانده |
events:read | خواندن رویدادهای مربوط به حساب شما، و ثبت نقطه‌های پایانی که آن‌ها را دریافت می‌کنند. | فهرست رویدادهاجریان رویدادها |
events:write | فرستادن رویدادها از بازی یا یکپارچه‌سازی شما به Lingara. | ارسال رویداد |
embed:mint | صدور توکن‌های کوتاه‌مدت برای بازیکنان بازی یا سایت شما و حذف بازیکنان. فقط برای کلاینت‌های با صورت‌حساب مبتنی بر مصرف. | صدور توکن برای بازیکنحذف بازیکنلغو پیوند بازیکن از حساب Lingara او |
embed:play | از طرف یک بازیکن عمل کنید: نتایج تمرینش را بفرستید و با او گفت‌وگوی NPC داشته باشید. | پیوند دادن بازیکن به حساب Lingara اویک جمله به یک شخصیت غیربازیکن بفرستید |
قیمت
هر اعتبار 0.004 دلار آمریکا هزینه دارد. مصرف به‌صورت ماهانه، برای هر ماه میلادی که از روز اول (UTC) آغاز می‌شود، از کارت اشتراک صورت‌حساب مصرفی شما صورت‌حساب می‌شود.
سقف‌های هزینه
حساب شما یک سقف ماهانه بر حسب اعتبار دارد و هر کلاینت metered می‌تواند سقف پایین‌تری از آنِ خود داشته باشد؛ هر دو را در صفحهٔ یکپارچه‌سازی‌ها تنظیم کنید. وقتی کلاینت یا حساب شما به سقف خود برسد، فراخوانی‌های کلاینت با 402 و کد spend_cap_reached رد می‌شوند تا ماه بعد آغاز شود یا سقف افزایش یابد.
وقتی صورت‌حساب مصرفی فعال نیست
فراخوانی‌های کلاینت metered تا زمانی که صورت‌حساب مصرفی فعال نباشد با 402 و کد metered_billing_inactive رد می‌شوند: پیش از راه‌اندازی آن، تا زمانی که پرداختی معوق است، و پس از لغو آن. صورت‌حساب مصرفی را در صفحهٔ یکپارچه‌سازی‌ها، در app.getlingara.com/admin، راه‌اندازی، مدیریت یا لغو کنید. مدیریت آن درگاه صورت‌حساب Stripe را باز می‌کند، جایی که می‌توانید کارت خود را تغییر دهید و فاکتورهایتان را بخوانید.
اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.