بەستنەوەی یاریزانێک بە هەژماری 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"

کتێبخانەیەکت پێ باشترە؟ بەشی کتێبخانەکان ببینە.

ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.