وصل کردن بازیکن به حساب Lingara او

نسخهٔ API 2026-10-virile-dragon

put https://api.getlingara.com/v1/embed/players/{player_ref}/link

یکی از بازیکنان شما را به حساب Lingara وصل می‌کند که همین حالا به برنامه شما دسترسی داده است. آن را با توکن سپرده‌شده‌ای که سرور شما برای آن حساب گرفته فراخوانی کنید، هرگز با توکن خود کلاینت تان. از آن پس توکن‌های بازیکن به‌جای حساب عمل می‌کنند، تا جایی که اجازه اجازه می‌دهد: events:read را درخواست کنید، ورنه پس از وصل چیزی دربارهٔ بازیکن نمی‌شنوید. پلان‌های تکمیل‌شده به حساب انتقال می‌یابند؛ پلانی که هنوز نوشته می‌شود تا فراخوانی دوبارهٔ شما می‌ماند. تکرار آن بی‌خطر است: تکرار پاسخ existing می‌دهد و آنچه را قبلاً انتقال نمی‌یافت انتقال می‌دهد. وصل کردن برای شما مصرفی ندارد.

حوزه‌های دسترسی embed:play

پارامترها

Lingara-Versionheaderstringاختیاری: نسخهٔ API‌ای که این درخواست با آن جواب داده می‌شود. بدون آن، توکن دسترسی نسخه‌ای را می‌گیرد که کلاینت آن به آن وصل است، و درخواستی بدون توکن نسخهٔ فعلی را می‌گیرد. به نسخه‌ای که هنوز در حال انکشاف است تنها با نام‌بردن آن در اینجا می‌توان رسید. نسخهٔ ناشناخته با 400 و کد api_version_unknown جواب داده می‌شود. GET /v1/versions نسخه‌ها را فهرست می‌کند.
player_refpathstringضروری: player_ref که با آن توکن‌های بازیکن را صادر کرده‌اید، با کدگذاری فیصدی: guild/42 می‌شود guild%2F42.

پاسخ‌ها

200 وصل بازیکن

statusLinkStatusضروری
subjectstringضروری: lgr_sub_ حساب: آنچه رویدادهای این بازیکن از این پس با خود دارند.
previous_subjectstringضروری: lgr_sub_ مهمان: آنچه رویدادهای قبلی بازیکن نگه می‌دارند. هر دو را به همان player_ref بفرستید.
linked_atstringضروری: زمان ایجاد وصل. در پاسخ existing، زمان نخستین فراخوانی.
scopesarray of stringضروری: بیشترین چیزی که توکنی برای این بازیکن اکنون می‌تواند داشته باشد: آنچه حساب اجازه داده، از میان ساحه‌هایی که توکن بازیکن می‌تواند داشته باشد.
carriedobjectضروری: ردیف‌هایی که این فراخوانی به حساب انتقال داد، به تفکیک جدول. تنها جدول‌هایی که شمارش دارند نشان داده می‌شوند.
keptobjectضروری: ردیف‌هایی که این فراخوانی نزد مهمان گذاشت، به تفکیک جدول: پلانی که هنوز نوشته می‌شود، یا ردیفی که حساب از قبل داشت. وقتی lesson_plans در اینجا پلان تکمیل‌شده داشت، دوباره فراخوانی کنید.

خطاها

402application/json: فراخوانی یک کلاینت مصرفی پیش از آنکه چیزی مصرف کند رد شد. spend_cap_reached: کلاینت یا حساب آن به سقف مصارف ماهانهٔ خود رسیده است؛ سقف را در صفحهٔ یکپارچه‌سازی‌ها بلند ببرید. metered_billing_inactive: صورت‌حساب مصرفی برای این حساب فعال نیست؛ آن را در صفحهٔ یکپارچه‌سازی‌ها تنظیم کنید یا روش پرداخت را تازه کنید.
410application/json: نسخهٔ API‌ای که این درخواست با آن جواب داده می‌شود متوقف شده است. یک نسخهٔ پشتیبانی‌شده را در Lingara-Version بفرستید، یا کلاینت را به نسخهٔ دیگری وصل کنید.
4XXapplication/json: درخواست رد شد. code دلیل را مشخص می‌کند و error آن را با کلمات بیان می‌کند.
503application/json · text/plain: خدمات به طور موقت در دسترس نیست؛ پس از تعداد ثانیه‌های ذکرشده در Retry-After دوباره کوشش کنید. در زمان ترمیمات، بدنهٔ پاسخ به جای پاکت خطا، متن ساده است.
5XXapplication/json: درخواست رد شد. code دلیل را مشخص می‌کند و error آن را با کلمات بیان می‌کند.

codestringضروری: دلیل رد شدن درخواست، به شکل کدی ثابت که می‌توان بر اساس آن تصمیم گرفت: برای مثال insufficient_scope (403)، rate_limited (429) و، برای یک کلاینت مصرفی، spend_cap_reached (402) و metered_billing_inactive (402).
errorstringضروری

نمونه

curl -X PUT "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

کتابخانه را ترجیح می‌دهید؟ بخش کتابخانه‌ها را ببینید.

اگر ترجمه با مرجع انگلیسی فرق داشته باشد، مرجع انگلیسی درست است.