Wasemir

Wasemir Discord API için JavaScript client kütüphanesi. Discord kullanıcı bilgilerini, presence durumlarını ve sunucu bilgilerini kolayca çekmenizi sağlar.

Kurulum

npm install wasemir

Kullanım

Temel Kullanım

const WasemirClient = require('wasemir');

// Client oluştur
const client = new WasemirClient('https://wasemir.wasetrox.com');

// Kullanıcı bilgilerini çek
async function getUserInfo() {
  try {
    const userData = await client.getUser('123456789012345678');
    console.log(userData);
  } catch (error) {
    console.error('Hata:', error.message);
  }
}

getUserInfo();

Gelişmiş Ayarlar

const client = new WasemirClient('https://wasemir.wasetrox.com', {
  timeout: 15000,  // 15 saniye timeout
  retries: 5       // 5 kez yeniden dene
});

API Metodları

getUser(userId)

Kullanıcının tüm bilgilerini çeker (v2 API).

const userData = await client.getUser('123456789012345678');
console.log(userData.user.username);
console.log(userData.user.hasNitro);
console.log(userData.presence?.status);

getUserBasic(userId)

Kullanıcının temel bilgilerini çeker.

const basicInfo = await client.getUserBasic('123456789012345678');
console.log(basicInfo.username);
console.log(basicInfo.avatar);
console.log('Has Nitro:', basicInfo.hasNitro);

getUserPresence(userId)

Kullanıcının presence bilgilerini çeker.

const presence = await client.getUserPresence('123456789012345678');
if (presence) {
  console.log('Durum:', presence.status);
  console.log('Aktiviteler:', presence.activities);
}

getUserBadges(userId)

Kullanıcının rozetlerini çeker.

const badges = await client.getUserBadges('123456789012345678');
badges.forEach(badge => {
  console.log(`${badge.emoji} ${badge.name}: ${badge.description}`);
});

getUserAvatar(userId)

Kullanıcının avatar bilgilerini çeker.

const avatar = await client.getUserAvatar('123456789012345678');
console.log('Avatar URL:', avatar.avatar);
console.log('Farklı boyutlar:', avatar.sizes);

getUserBanner(userId)

Kullanıcının banner bilgilerini çeker.

const banner = await client.getUserBanner('123456789012345678');
console.log('Banner URL:', banner.banner);
console.log('Has Nitro:', banner.hasNitro);
console.log('Accent Color:', banner.accentColor);

getUserActivities(userId)

Kullanıcının aktif aktivitelerini çeker.

const activities = await client.getUserActivities('123456789012345678');
activities.forEach(activity => {
  console.log(`${activity.type}: ${activity.name}`);
  if (activity.details) console.log(`Detay: ${activity.details}`);
});

getConfig()

API konfigürasyonunu çeker.

const config = await client.getConfig();
console.log('Discord davet linki:', config.discordInvite);

getUserV1(userId)

V1 API versiyonunu kullanır.

const userData = await client.getUserV1('123456789012345678');

getUserLegacy(userId)

Eski API versiyonunu kullanır (geriye uyumluluk için).

const userData = await client.getUserLegacy('123456789012345678');

Hata Yönetimi

Client otomatik olarak hataları yakalar ve anlamlı hata mesajları döner:

try {
  const userData = await client.getUser('invalid-id');
} catch (error) {
  if (error.message.includes('bulunamadı')) {
    console.log('Kullanıcı mevcut değil');
  } else if (error.message.includes('Rate limit')) {
    console.log('Çok fazla istek gönderildi, bekleyin');
  } else {
    console.log('Bilinmeyen hata:', error.message);
  }
}

Retry Mekanizması

Client otomatik olarak başarısız istekleri yeniden dener:

• Network hataları için otomatik retry
• Server hataları (5xx) için otomatik retry
• Rate limit (429) için otomatik retry
• Exponential backoff ile bekleme süresi

TypeScript Desteği

Kütüphane TypeScript tip tanımları ile birlikte gelir:

import WasemirClient from 'wasemir';

const client = new WasemirClient('https://wasemir.wasetrox.com');

// Tip güvenli kullanım
const userData: UserData = await client.getUser('123456789012345678');

Örnek Projeler

Basit Kullanıcı Profili

const WasemirClient = require('wasemir');

async function showUserProfile(userId) {
  const client = new WasemirClient('https://wasemir.wasetrox.com');
  
  try {
    const userData = await client.getUser(userId);
    const user = userData.user;
    
    console.log(`👤 ${user.displayName} (@${user.username})`);
    console.log(`🆔 ID: ${user.id}`);
    console.log(`📅 Hesap oluşturma: ${new Date(user.createdAt).toLocaleDateString('tr-TR')}`);
    console.log(`💎 Nitro: ${user.hasNitro ? 'Evet' : 'Hayır'}`);
    
    if (userData.presence) {
      console.log(`🟢 Durum: ${userData.presence.status}`);
      
      if (userData.presence.activities.length > 0) {
        console.log('🎮 Aktiviteler:');
        userData.presence.activities.forEach(activity => {
          console.log(`  ${activity.type}: ${activity.name}`);
        });
      }
    }
    
    if (user.badges.length > 0) {
      console.log('🏆 Rozetler:');
      user.badges.forEach(badge => {
        console.log(`  ${badge.emoji} ${badge.name}`);
      });
    }

    // Avatar ve banner bilgileri
    const avatar = await client.getUserAvatar(userId);
    console.log(`🖼️ Avatar: ${avatar.avatar}`);
    
    const banner = await client.getUserBanner(userId);
    if (banner.banner) {
      console.log(`🎨 Banner: ${banner.banner}`);
    } else if (banner.accentColor) {
      console.log(`🎨 Accent Color: #${banner.accentColor.toString(16)}`);
    }
    
  } catch (error) {
    console.error('Kullanıcı bilgileri alınamadı:', error.message);
  }
}

showUserProfile('123456789012345678');

Avatar ve Banner Örneği

const WasemirClient = require('wasemir');

async function getAvatarAndBanner(userId) {
  const client = new WasemirClient('https://wasemir.wasetrox.com');
  
  try {
    // Avatar bilgileri
    const avatar = await client.getUserAvatar(userId);
    console.log('Avatar Bilgileri:');
    console.log(`  URL: ${avatar.avatar}`);
    console.log(`  Farklı boyutlar:`);
    Object.entries(avatar.sizes).forEach(([size, url]) => {
      console.log(`    ${size}px: ${url}`);
    });

    // Banner bilgileri
    const banner = await client.getUserBanner(userId);
    console.log('\nBanner Bilgileri:');
    console.log(`  Has Nitro: ${banner.hasNitro}`);
    
    if (banner.banner) {
      console.log(`  Banner URL: ${banner.banner}`);
      console.log(`  Farklı boyutlar:`);
      Object.entries(banner.sizes).forEach(([size, url]) => {
        console.log(`    ${size}px: ${url}`);
      });
    } else if (banner.accentColor) {
      console.log(`  Accent Color: #${banner.accentColor.toString(16)}`);
    }
    
  } catch (error) {
    console.error('Hata:', error.message);
  }
}

getAvatarAndBanner('123456789012345678');

Lisans

MIT

Katkıda Bulunma

1. Fork yapın
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Commit yapın (git commit -m 'Add some amazing feature')
4. Branch'i push edin (git push origin feature/amazing-feature)
5. Pull Request açın

Destek

Sorunlar için GitHub Issues kullanın.