Skip to content

Latest commit

 

History

History
132 lines (101 loc) · 2.64 KB

README.md

File metadata and controls

132 lines (101 loc) · 2.64 KB

SetScript Discord Presence API

Discord kullanıcı durumlarını ve aktivitelerini gerçek zamanlı olarak takip etmek için RESTful API servisi.

🚀 Özellikler

  • Kullanıcı durumu ve aktiviteleri (JSON)
  • Özelleştirilebilir presence kartı (HTML/PNG)
  • Spotify aktivite bilgisi
  • Custom status desteği
  • Emoji desteği (Discord ve Unicode)
  • Rate limiting ve DDoS koruması

📚 API Kullanımı

Kullanıcı Bilgilerini Al (JSON)

GET http://localhost:5550/users/:userId

Örnek yanıt:

{
  "user": {
    "id": "123456789",
    "username": "username",
    "tag": "username#0000",
    "avatarURL": "https://cdn.discordapp.com/avatars/..."
  },
  "presence": {
    "status": "online",
    "customStatus": {
      "text": "Hello World",
      "emoji": { ... }
    }
  },
  "spotify": {
    "title": "Song Name",
    "artist": "Artist Name",
    "albumArtURL": "https://i.scdn.co/image/..."
  },
  "activities": [ ... ]
}

Presence Kartı Al (HTML/PNG)

HTML formatında:

GET http://localhost:5550/users/card/:userId

PNG formatında:

GET http://localhost:5550/users/card/:userId?img

API Durumu

GET http://localhost:5550/health

API Dokümantasyonu

GET http://localhost:5550/docs

📦 Kurulum

  1. Repoyu klonlayın:
git clone https://github.com/setscript/SetScript-Discord-Presence-Fetch.git
  1. Bağımlılıkları yükleyin:
npm install
  1. Uygulamayı başlatın:
npm start

🔒 Rate Limiting

  • Her endpoint için 5 dakikada 25 istek
  • Burst limiti: 1 saniyede maksimum 10 istek
  • IP bazlı rate limiting

📝 Örnekler

Node.js ile Kullanım

const response = await fetch('http://localhost:5550/users/123456789');
const data = await response.json();
console.log(data.presence.status);

Python ile Kullanım

import requests

response = requests.get('http://localhost:5550/users/123456789')
data = response.json()
print(data['presence']['status'])

HTML/JavaScript ile Kullanım

<img src="http://localhost:5550/users/card/123456789?img" alt="Discord Presence">

⚠️ Notlar

  • API'yi kullanmak için kullanıcının Discord sunucumuzda olması gerekiyor
  • Rate limit aşımında 429 status kodu döner
  • Kullanıcı bulunamadığında 404 status kodu döner
  • Sunucu hatalarında 500 status kodu döner

🔗 Linkler

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.