Geliştirici API Belgeleri

Uç noktalar

GET · HEAD · OPTIONS

/api/v1/bot/status

Bot çevrimiçi durumu ve toplu istatistikler. Güncelleme: kısa önbellek.

GET · HEAD · OPTIONS

/api/v1/bot/commands

En fazla 100 slash komutu, açıklamaları, kategorileri ve seçenekleri.

GET · HEAD · OPTIONS

/api/v1/features

Özellik adları, açıklamaları ve plan seviyesi.

GET · HEAD · OPTIONS

/api/v1

API sürümü ve kaynak dizini. Alternatif: /api/v1/meta.

JSON · UTF-8Salt okunurSorgu parametresi yokGiriş bilgisi gerekmez

Hızlı başlangıç

Tarayıcıdan veya sunucunuzdan yalnızca yayınlanan uç noktalara GET isteği gönderin. Kimlik bilgisi göndermeyin ve API yanıtındaki metni HTML olarak çalıştırmayın.

JavaScript · Fetch

const response = await fetch('/api/v1/bot/status', {
  headers: { Accept: 'application/json' },
  credentials: 'omit'
});

if (!response.ok) throw new Error(`API: ${response.status}`);
const bot = await response.json();
console.log(bot.online, bot.guilds);

cURL

curl --fail-with-body -H 'Accept: application/json' \
  https://bytenetwork.wasmer.app/api/v1/bot/status

Önbellek ve sınırlar

Her istemci IP’si için dakikada en fazla 60 istek. Uygulama süreçleri arasında paylaşılan dağıtık sayaç değildir.
Sınır aşılırsa 429 Too Many Requests, Retry-After ve X-RateLimit-Limit / Remaining / Reset başlıkları döner.
Başarılı yanıtlar ETag taşır. If-None-Match ile değişmemiş yanıt için 304 alınabilir.
Sorgu parametresi için 400, bilinmeyen yol için 404, yazma metotları için 405 döner.
Bot durumu kısa, statik listeler daha uzun süre önbelleğe alınır. Yanıtlar veritabanı sorgusu yapmaz.
Tarayıcı kullanımı için herkese açık CORS açıktır. Kimlik bilgisi / çerez CORS izni verilmez.
Yazma istekleri, webhook tetikleme, özel sunucu listeleri ve kullanıcı verileri Public API v1 kapsamında değildir.

İstemciye nazikçe davranın, istekleri önbelleğe alın ve 429 sonrasında bekleyin. Yüksek hacimli toplu çekim veya güvenlik açığı testi için önce destek sunucusunda iletişim kurun.

Canlı deneme

Seçili genel kaynağı aynı tarayıcıdan sorgular. Çıkış, ham JSON’dur.

Bir uç nokta seçip GET gönder’e basın.

Yanıt örneği

GET /api/v1/bot/status

{
  "online": true,
  "guilds": 120,
  "users": 18400,
  "latencyMs": 58,
  "commandCount": 76,
  "uptimeSeconds": 86400,
  "version": "4.3.0",
  "lastUpdatedAt": 1791234567890
}

Örnek sayılar açıklama amaçlıdır; canlı değerler değişebilir. Bot çevrimdışıyken online false, version null ve uptimeSeconds 0 döner.