Bir oyuncuyu Lingara hesabına bağla

API sürümü 2026-10-virile-dragon

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

Oyuncularınızdan birini, uygulamanıza az önce erişim veren Lingara hesabına bağlar. Bunu sunucunuzun o hesap için aldığı devredilmiş belirteçle çağırın, asla istemcinizin kendi belirteciyle değil. Bundan sonra oyuncunun belirteçleri, iznin elverdiği ölçüde o hesap olarak davranır: events:read isteyin, yoksa bağlantıdan sonra oyuncu hakkında hiçbir şey duymazsınız. Tamamlanan planlar hesaba taşınır; hâlâ yazılmakta olan bir plan siz yeniden çağırana kadar kalır. Tekrarlamak güvenlidir: tekrar existing yanıtı verir ve daha önce taşınamayanı taşır. Bağlama size hiçbir ücret getirmez.

Kapsamlar embed:play

Parametreler

Lingara-Versionheaderstringisteğe bağlı: Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm 400 ve api_version_unknown koduyla yanıtlanır. GET /v1/versions sürümleri listeler.
player_refpathstringzorunlu: Oyuncunun tokenlarını oluştururken kullandığınız player_ref, yüzde kodlamalı: guild/42, guild%2F42 olur.

Yanıtlar

200 Oyuncunun bağlantısı

statusLinkStatuszorunlu
subjectstringzorunlu: Hesabın lgr_sub_ değeri: bu oyuncunun olaylarının bundan sonra taşıdığı değer.
previous_subjectstringzorunlu: Misafirin lgr_sub_ değeri: oyuncunun önceki olaylarının koruduğu değer. İkisini de aynı player_ref değerine yönlendirin.
linked_atstringzorunlu: Bağlantının oluşturulduğu zaman. existing yanıtında, ilk çağrının zamanı.
scopesarray of stringzorunlu: Bu oyuncu için bir belirtecin artık taşıyabileceği en fazla şey: bir oyuncu belirtecinin taşıyabileceği kapsamlardan hesabın izin verdikleri.
carriedobjectzorunlu: Bu çağrının hesaba taşıdığı satırlar, tablo başına. Yalnızca sayısı olan tablolar görünür.
keptobjectzorunlu: Bu çağrının misafirde bıraktığı satırlar, tablo başına: hâlâ yazılmakta olan bir plan ya da hesapta zaten bulunan bir satır. Buradaki lesson_plans tamamlanmış bir plan içerdiğinde yeniden çağırın.

Hatalar

402application/json: Kullanım başına ücretlendirilen bir istemcinin çağrısı, hiçbir şey harcamadan reddedildi. spend_cap_reached: istemci veya hesabı aylık harcama sınırına ulaştı; sınırı Entegrasyonlar sayfasında yükseltin. metered_billing_inactive: bu hesap için kullanım başına ücretlendirme etkin değil; Entegrasyonlar sayfasında kurun veya ödeme yöntemini güncelleyin.
410application/json: Bu isteğin yanıtlandığı API sürümü sonlandırıldı. Lingara-Version içinde desteklenen bir sürüm gönderin veya istemciyi başka bir sürüme bağlayın.
4XXapplication/json: İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.
503application/json · text/plain: Hizmet geçici olarak kullanılamıyor; Retry-After içindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir.
5XXapplication/json: İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

codestringzorunlu: İsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin insufficient_scope (403), rate_limited (429) ve kullanım başına ücretlendirilen bir istemci için spend_cap_reached (402) ile metered_billing_inactive (402).
errorstringzorunlu

Örnek

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

Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.

Bir çeviri ile İngilizce referans arasında fark varsa, İngilizce referans geçerlidir.