Pautkan pemain kepada akaun Lingara mereka

Versi API 2026-10-virile-dragon

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

Memautkan salah seorang pemain anda kepada akaun Lingara yang baru sahaja memberi akses kepada aplikasi anda. Panggilnya dengan token terwakil yang diterima pelayan anda untuk akaun itu, jangan sekali-kali dengan token klien anda sendiri. Sejak itu token pemain bertindak sebagai akaun tersebut, setakat yang dibenarkan oleh kebenaran: minta events:read atau anda tidak akan mendengar apa-apa tentang pemain selepas pautan. Pelan yang sudah selesai berpindah ke akaun; pelan yang masih ditulis kekal sehingga anda memanggil semula. Selamat diulang: ulangan menjawab existing dan memindahkan apa yang sebelum ini tidak dapat dipindahkan. Pautan tidak dikenakan kos.

Skop embed:play

Parameter

Lingara-Versionheaderstringpilihan: Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab 400 dengan kod api_version_unknown. GET /v1/versions menyenaraikan versi.
player_refpathstringwajib: player_ref yang anda gunakan untuk mengeluarkan token pemain, dikodkan peratus: guild/42 ialah guild%2F42.

Respons

200 Pautan pemain

statusLinkStatuswajib
subjectstringwajib: lgr_sub_ akaun: apa yang dibawa oleh acara pemain ini mulai sekarang.
previous_subjectstringwajib: lgr_sub_ tetamu: apa yang dikekalkan oleh acara terdahulu pemain. Hala kedua-duanya ke player_ref yang sama.
linked_atstringwajib: Bila pautan dicipta. Pada jawapan existing, masa panggilan pertama.
scopesarray of stringwajib: Paling banyak yang boleh dipegang oleh token untuk pemain ini sekarang: apa yang dibenarkan akaun, daripada skop yang boleh dibawa token pemain.
carriedobjectwajib: Baris yang dipindahkan panggilan ini ke akaun, mengikut jadual. Hanya jadual yang ada kiraan dipaparkan.
keptobjectwajib: Baris yang ditinggalkan panggilan ini dengan tetamu, mengikut jadual: pelan yang masih ditulis, atau baris yang akaun sudah ada. Panggil semula sebaik sahaja lesson_plans di sini mempunyai pelan yang sudah selesai.

Ralat

402application/json: Panggilan klien bermeter telah ditolak sebelum ia membelanjakan apa-apa. spend_cap_reached: klien atau akaunnya telah mencapai had perbelanjaan bulanannya; naikkan had di halaman Integrasi. metered_billing_inactive: pengebilan bermeter tidak aktif untuk akaun ini; sediakannya, atau kemas kini kaedah pembayaran, di halaman Integrasi.
410application/json: Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Hantar versi yang disokong dalam Lingara-Version, atau pautkan klien kepada versi lain.
4XXapplication/json: Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.
503application/json · text/plain: Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat.
5XXapplication/json: Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

codestringwajib: Sebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya insufficient_scope (403), rate_limited (429) dan, bagi klien bermeter, spend_cap_reached (402) dan metered_billing_inactive (402).
errorstringwajib

Contoh

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

Lebih suka pustaka? Lihat bahagian Pustaka.

Jika terjemahan dan rujukan bahasa Inggeris berbeza, rujukan bahasa Inggeris adalah yang betul.