İçeriğe geç
N'oluyo
Kayıt ol
Kaynaklar

Değişiklikler

Son güncelleme:
.md indirMarkdown aç.html indirTam PDF
Bu sayfada

API'deki değişiklikler burada, en yenisi üstte olacak şekilde yazılır.

6. aşama: N'oluyo ile giriş, doğrulama, bot rehberi ve resmi kütüphaneler

Kullanıcıların kendi hesaplarıyla üçüncü taraf sitelere giriş yapması, büyüyen uygulamalar için doğrulama ve rehber süreci, iki dilde resmi noluyo-bot kütüphaneleri ve yapay zeka uyumlu doküman paketleri eklendi.

Eklenenler

Var olan botlara etkisi

  • Mevcut REST rotaları, WebSocket gateway çerçeveleri ve ses akışı geriye dönük uyumludur; çalışan botlarda kod değişikliği gerekmez.

  • 100 sunucunun altındaki botlar eskisi gibi doğrulama başvurusu yapmadan çalışmayı sürdürür. Uygulama ilk kez oluşturulurken geliştirici sözleşmesi onayı (developer_terms_required) istenir; var olan uygulamalar kesintisiz çalışmaya devam eder.

  • Acil durdurulan bir uygulamanın bot token'ı güvenlik gereği kalıcı olarak iptal edilir; uygulama yeniden açıldığında portaldan yeni token üretilir.

5. aşama: seste bot

Botlar artık ses kanallarına girip müzik, duyuru ya da ses efekti yayınlayabilir; ses kanallarındaki kimseyi ise hiçbir koşulda duyamaz.

Eklenenler

  • Ses: gateway op 4 ile ses kanalına girme ve çıkma, VOICE_SERVER_UPDATE ve VOICE_JOIN_ERROR olayları, LiveKit üzerinden ffmpeg ile çalışan örnek (cal.mjs) ve bot ses sınırları.

  • Bir bot farklı sunucularda aynı anda birden çok ses kanalında bulunabilir; web, masaüstü (oyun içi arayüz dahil) ve Android istemcilerinde BOT etiketiyle gösterilir ve kanalın kişi sınırına sayılmaz.

  • Gateway sayfasındaki connect() yardımcısı artık { send(op, d) } döndürür; var olan örnekler dönüş değerini kullanmadığı için kırılmaz.

Hâlâ olmayanlar

  • Resmi kütüphaneler

4. aşama: komutlar, formlar, özel mesajlar ve herkese açık beta

Bot platformu herkese açık beta olarak açıldı: e-postası doğrulanmış her hesap geliştirici sözleşmesini kabul edip uygulama oluşturabilir ve bot ekleyebilir. Davet ve bots_closed / bot_developer_required hataları kalktı.

Eklenenler

  • Komutlar: / listesinde ve kişi ya da mesaja sağ tıklayınca menüde görünen komutlar.

  • Otomatik tamamlama: komut seçeneğine yazarken en çok 25 öneri.

  • Formlar: komuta ya da butona yanıt olarak açılan, en çok beş alanlı pencere.

  • Özel mesajlar: kişi botla DM açar; komutlar, butonlar ve formlar orada da çalışır. Bot asla ilk yazan olmaz.

  • Komut izinleri: sunucu yöneticileri komutların kimde ve hangi kanalda çalışacağını belirler.

  • HTTP ile teslim: etkileşimleri gateway yerine imzalı bir https adresine aldır.

  • Roller artık arayüzde ID'si ile kopyalanabilir; bkz. İzinler.

Hâlâ olmayanlar

  • Botların ses kanalına girmesi

  • Resmi kütüphaneler

3. aşama: embed, bileşen ve etkileşimler

Botların mesajları artık kart, buton ve menü taşıyabilir; basmalar bota gelir. Erişim o dönemde hâlâ davetleydi.

Eklenenler

  • Embed'ler: başlık, açıklama, alanlar, renk, zaman ve aynı mesajla yüklenen görseller (attachment://). Mesajda en çok 10 embed.

  • Bileşenler: beş stilde buton, bağlantı butonu, metin, kullanıcı, rol ve kanal menüsü.

  • Etkileşimler: INTERACTION_CREATE olayı ve dört yanıt türü (type 4, 5, 6, 7), @original düzenlemesi, takip mesajları.

  • Yalnızca basan kişinin gördüğü mesajlar (flags: 64).

  • Botlar için tam allowed_mentions: parse, users, roles, replied_user.

  • Webhook mesajlarında embed.

  • Yeni hız sınırı sınıfı interaction ve büyük embed'ler için tüm botların ortak bütçesi; ayrıntı Hız sınırları sayfasında.

  • Çalışan üç yeni örnek: anket, rol seçici ve sayfalı liste.

2. aşamaya göre değişenler

Bunlar var olan botları etkileyebilir:

  • embeds, components ve flags artık okunuyor. Önceden botun isteğindeki bu alanlar bilinmeyen alan olarak yok sayılırdı. Şimdi denetlenir: kurala uymayan bir embed ya da bileşen 400 validation_failed, kanal mesajında flags: 64 400 ephemeral_forbidden, başka bir flags değeri {"flags":"invalid"} döner. Bu alanları gönderip sonucun yok sayılmasına güvenen bir bot artık hata alabilir.

  • allowed_mentions tam uygulanıyor. Önceden yalnızca replied_user okunurdu. Şimdi "parse": [] gönderen bir botun mesajındaki etiketler bildirim göndermez; eskiden gönderirdi. parse ile aynı türün listesini birlikte göndermek ya da parse içinde bilinmeyen bir değer 400 validation_failed döner.

  • Mesaj düzenleme (PATCH) artık kısmi. Önceden content zorunluydu. Şimdi content, embeds ve components ayrı ayrı gönderilir, göndermediğin alan olduğu gibi kalır. content göndermeden yapılan bir PATCH artık kabul edilir; "content": "" mesajda metin, embed ya da dosya bırakmıyorsa yine required döner.

  • Webhook'un embeds'i denetleniyor. Önceden alınıp atılırdı. Şimdi liste olmayan embeds 400 invalid_body, sınırı aşan bir alan 400 validation_failed döner. Yalnızca embed içeren istek eskiden boş içerik diye 400 alırdı, şimdi çalışır. Görsel alanları sessizce düşer.

  • Yeni bir olay. INTERACTION_CREATE, hangi intent'leri istersen iste bağlantına gelir. Bilmediğin olayları yok say.

  • Mesajda yeni alanlar. Mesaj nesnesinde embeds, components, flags, application_id ve interaction gelebilir. Mesaj içeriği olmayan bota başkalarının embeds ve components'i gelmez.

Henüz olmayanlar

Bunlar ileride gelecek:

  • Botların ses kanalına girmesi

  • Resmi kütüphaneler

2. aşama: gateway

Botlar artık olayları canlı dinleyebilir. Erişim o dönemde davetleydi.

Eklenenler

  • Bot gateway'i: WebSocket bağlantısı, heartbeat, identify, resume ve kapanış kodları. Adresi GET /gateway/bot söyler.

  • Olaylar: mesajlar, tepkiler, üyeler, roller, kanallar, ses, durum ve diğerleri; her biri alanları ve örneğiyle.

  • Intent'ler: bot istediği olayları seçer. Üç ayrıcalıklı intent portaldan açılır.

  • Shard'lar: çok sunuculu botlar için birden çok bağlantı, önerilen ve zorunlu sayı.

  • op 3 ile botun durumunu değiştirme, op 8 ile üye listesi ve arama.

  • Tüm botların ortak yazma tavanı: X-RateLimit-Scope: shared.

1. aşamaya göre değişenler

Bunlar var olan botları etkileyebilir:

  • REST okumalarında içerik kuralı. Sunucu kanallarında mesaj listesi, tek mesaj ve sabitlenenler artık Mesaj içeriği açık olmayan bir bota metni, ekleri ve diğer içeriği süzülmüş olarak döner; botun kendi mesajları ve kendisini etiketleyen mesajlar hariç. Kanalı okuyan eski botlar content alanını boş görür: portaldan Mesaj içeriği'ni aç.

  • İletmede içerik kuralı. Bot okuyamadığı bir mesajı iletemez: 400 validation_failed, {"forward":"invalid"}.

  • Üye listesi intent ister. GET /guilds/{guild_id}/members, Sunucu üyeleri açık olmayan bota artık 403 member_list_intent_required döner. Tek üye istemek açık kalır.

  • Token yenileme. Eski token'la açık gateway bağlantıları 4004 ile hemen kapanır.

1. aşama: kapalı dönem

Bot API'nin ilk sürümü. Erişim davetle açılıyor.

Eklenenler

  • Geliştirici portalı: uygulama oluşturma, token, ekleme bağlantısı.

  • Uygulamalar ve bot hesapları; Authorization: Bot <token> ile kimlik doğrulama.

  • Botu sunucuya ekleme ve bota ait yönetilen rol.

  • Bot rotaları: kullanıcı, sunucu, kanal, rol, üye, yasak, mesaj, sabitleme ve tepki işlemleri.

  • X-RateLimit-* başlıklarıyla hız sınırları ve geçersiz istekler için geçici engel.

Bu sayfayı yapay zekaya verirsen

Sırada ne var