findcord/README.md

discord botları için tasarlanmış bir api

# findcord

![npm](https://img.shields.io/npm/v/findcord)
![npm](https://img.shields.io/npm/dt/findcord)

## Açıklama

`findcord`, Discord kullanıcı bilgilerini hızlı ve kolay bir şekilde almanıza olanak sağlayan bir Node.js paketidir.

## Kurulum

Paketi projenize eklemek için npm veya yarn kullanabilirsiniz:

```bash
npm install findcord
```

veya

```bash
yarn add findcord
```

## Kullanım

```javascript
const Findcord = require('findcord').default //esModule ise default ekleyin. Eğer değilse koymaya gerek yoktur.
const data = new Findcord('API_ANAHTARINIZ'); //discord.gg/findcord sunucusundan temin edebilirsiniz.


// Kullanıcı bilgilerini almak
data.fetch('Kullanıcı ID').then((response) => {
    console.log(response);
});

// Kullanıcı kayıt sorgusu yapmak
data.query('Kullanıcı ID').then((response) => {
    console.log(response);
});

//Örnek Kullanım

const Findcord = require('findcord').default;
const data = new Findcord('API_ANAHTARINIZ');

data.fetch('123456789012345678') // Belirli bir kullanıcının ID'si
  .then((user) => {
    console.log(`Kullanıcı Adı: ${user.username}`);
    console.log(`Bio: ${user.bio}`);
    console.log(`Avatar URL: ${user.displayAvatarURL({ dynamic: true, size: 1024 })}`);
    console.log(`Son Görülme: ${user.lastseen.message ? user.lastseen.message.content : 'Bilinmiyor'}`);
    console.log(`Sunucularda Görevli Olduğu Roller:`);
    user.staffs.forEach(staff => {
      console.log(`- ${staff.name} sunucusunda görevli.`);
    });
  })
  .catch(error => {
    console.error('Hata oluştu:', error);
  });

//Query kısmından Kullanıcı'nın Top Name, Age ve Gender Bilgisini Alabilirsiniz.

  data.query('123456789012345678')
  .then((query) => {
    if (query.age > 18) {
      console.log('Kullanıcı 18 yaşından büyük.');
    } else {
      console.log('Kullanıcı 18 yaşından küçük veya yaşı belirtilmemiş.');
    }
    console.log(`Tam Adı (Taglı): ${query.fullName({ isTagged: true })}`);
  })
  .catch(error => {
    console.error('Hata oluştu:', error);
  });

//Kullanıcıların Son Mesajlarını Analiz Etme
data.fetch('123456789012345678')
  .then((user) => {
    if (user.lastseen.message) {
      console.log(`Son mesajın gönderildiği kanal: ${user.lastseen.message.channel.name}`);
      console.log(`Son mesajın içeriği: ${user.lastseen.message.content}`);
    } else {
      console.log('Kullanıcının son mesajı bulunamadı.');
    }
  });

```

## Önemli Notlar
- API Anahtarı: Kütüphaneyi kullanmak için geçerli bir API anahtarınız olması gerekmektedir. Bu anahtarı https://discord.gg/findcord sunucusundan temin edebilirsiniz.
- Hata Yönetimi: Herhangi bir API çağrısı yaparken hata oluşma ihtimaline karşı gerekli hata yönetimi mekanizmalarını kullanmalısınız.
- Rate Limit: API kullanım sınırlarına dikkat etmelisiniz. Fazla istekte bulunmak hesabınızın geçici olarak engellenmesine neden olabilir.

## Lisans

Bu proje LGPL-3.0-or-later lisansı altında lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakabilirsiniz.
```