{ "document": { "title": "MissXss API AI Reference", "language": "tr", "generated_at": "2026-09-19T01:14:10+03:00", "purpose": "Bu dokuman yapay zeka araclarinin MissXss API endpointlerini, parametrelerini, scope gereksinimlerini ve ornek istek/yanitlarini anlayabilmesi icin uretilmistir." }, "authentication": { "scheme": "Bearer", "header": "Authorization: Bearer YOUR_API_KEY", "notes": [ "API key degeri API Key Yonetimi sayfasindan olusturulur.", "Her API key yalnizca secilen scopelar icin calisir." ] }, "base_url": "https://api.missxss.com.tr", "request_format": { "method": "POST", "content_type": "application/json", "body": "Endpoint parametrelerini JSON body olarak gonderin." }, "available_scopes": [], "endpoint_count": 64, "groups": [ { "key": "chat", "name": "Sohbet ve Mesajlaşma", "endpoints": [ { "scope": "send-message", "scope_label": "Mesaj Gönder (Yayıncı Olarak)", "name": "Mesaj Gönder (Yayıncı Olarak)", "description": "Yayıncı hesabınız üzerinden chate mesaj gönderir. Mesaj, kendi adınızla görünür.", "method": "POST", "url": "https://api.missxss.com.tr/v1/send-message", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "message", "type": "string", "required": true, "description": "Gönderilecek mesaj metni (1-500 karakter)" }, { "name": "platform", "type": "string", "required": false, "description": "Hedef platform: Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "message": "Hello Chat!" }, "example_success_response": { "success": true, "message_id": "abc123" }, "rate_limit_per_minute": 90 }, { "scope": "send-bot-message", "scope_label": "Mesaj Gönder (Bot Olarak)", "name": "Mesaj Gönder (Bot Olarak)", "description": "MissXss bot hesabı üzerinden chate mesaj gönderir. Mesaj, bot adıyla görünür.", "method": "POST", "url": "https://api.missxss.com.tr/v1/send-bot-message", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "message", "type": "string", "required": true, "description": "Gönderilecek mesaj metni (1-500 karakter)" }, { "name": "platform", "type": "string", "required": false, "description": "Hedef platform: Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "message": "This is a bot message!" }, "example_success_response": { "success": true, "message_id": "def456" }, "rate_limit_per_minute": 90 }, { "scope": "tts", "scope_label": "TTS Mesajı Okut", "name": "TTS Mesajı Okut", "description": "Yayında sesli mesaj okutturur. Overlay'in bağlı olması gerekir. Dakikada maksimum istek sınırı (rate limit) uygulanır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/tts", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "text", "type": "string", "required": true, "description": "Sesli okunacak metin (1-500 karakter)" }, { "name": "username", "type": "string", "required": false, "description": "Ekranda gösterilecek kullanıcı adı (varsayılan: \"API\")" } ], "example_request_body": { "text": "Merhaba Yayın!", "username": "Bot" }, "example_success_response": { "success": true, "ttsId": "a1b2c3d4..." }, "rate_limit_per_minute": 20 } ] }, { "key": "stream", "name": "Yayın Kontrolleri", "endpoints": [ { "scope": "clip", "scope_label": "Klip Al", "name": "Klip Al", "description": "Aktif yayından anlık klip oluşturur. Kick'te eklenti bağlantısı, Twitch'te API ile çalışır. Yayının açık olması gerekir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/clip", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "title", "type": "string", "required": false, "description": "Klip başlığı (varsayılan: \"Clip - MissXss API\")" }, { "name": "duration", "type": "integer", "required": false, "description": "Klip süresi (5-180 saniye, varsayılan: 30)" }, { "name": "platform", "type": "string", "required": false, "description": "Yalnızca seçilen platformdan klip almak için Kick veya Twitch. Gönderilmezse ya da all gönderilirse tüm canlı platformlardan klip alınır." }, { "name": "send_chat_message", "type": "boolean", "required": false, "description": "Klip bağlantısını sohbete gönderir. false gönderilirse hiçbir platforma sohbet mesajı gönderilmez (varsayılan: true)." } ], "example_request_body": { "title": "Epic moment!", "duration": 45, "platform": "all", "send_chat_message": true }, "example_success_response": { "success": true, "platform": "all", "send_chat_message": true, "clips": { "kick": "https://kick.com/channel/clips/clip_id", "twitch": "https://clips.twitch.tv/clip_id" }, "platforms": { "kick": "created", "twitch": "created" } }, "rate_limit_per_minute": 20 }, { "scope": "game", "scope_label": "Oyun / Kategori Değiştir", "name": "Oyun / Kategori Değiştir", "description": "Yayın kategorisini değiştirir. Platform gönderilmezse Kick ve Twitch birlikte güncellenir; platform gönderilirse yalnızca seçilen platform güncellenir. Oyun adı veya Kick kategori ID gönderilebilir; her ikisi gönderilirse ID önceliklidir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/game", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "game", "type": "string", "required": false, "description": "Oyun/kategori adı (ör: \"Valorant\"). kick_category_id gönderilmezse zorunludur." }, { "name": "kick_category_id", "type": "integer", "required": false, "description": "Kick kategori ID'si. Biliniyorsa doğrudan ID göndermek daha hızlıdır." }, { "name": "platform", "type": "string", "required": false, "description": "Yalnızca bir platformu güncellemek için Kick veya Twitch. Gönderilmezse ikisi de güncellenir." } ], "example_request_body": { "game": "Valorant" }, "example_success_response": { "success": true, "game": "VALORANT", "platform": "all" }, "rate_limit_per_minute": 20 }, { "scope": "search-games", "scope_label": "Akıllı Oyun / Kategori Ara", "name": "Akıllı Oyun / Kategori Ara", "description": "Oyun veritabanında akıllı arama yapar. Tam isim eşleşmesi, slug, başlangıç eşleşmesi, kelime kapsama ve yazım benzerliği birlikte skorlanır; en yakın oyunlar benzerlik oranına göre döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/search-games", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "query", "type": "string", "required": true, "description": "Aranacak oyun/kategori adı (2-100 karakter). game veya search alanı da kabul edilir." }, { "name": "limit", "type": "integer", "required": false, "description": "Dönecek maksimum kayıt sayısı (1-50, varsayılan: 10)" }, { "name": "min_similarity", "type": "number", "required": false, "description": "Minimum benzerlik skoru (0-100, varsayılan: 25)" } ], "example_request_body": { "query": "banana", "limit": 10 }, "example_success_response": { "success": true, "query": "banana", "total": 3, "best_match": { "kick_category_id": 123, "name": "Banana", "slug": "banana", "score": 100, "match_type": "exact_name" }, "games": [ { "kick_category_id": 123, "name": "Banana", "slug": "banana", "score": 100, "match_type": "exact_name" } ] }, "rate_limit_per_minute": 40 }, { "scope": "title", "scope_label": "Yayın Başlığı Değiştir", "name": "Yayın Başlığı Değiştir", "description": "Yayın başlığını değiştirir. Platform gönderilmezse bağlı Kick, Twitch ve YouTube hesapları güncellenir; platform gönderilirse yalnızca seçilen platform güncellenir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/title", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "title", "type": "string", "required": true, "description": "Yeni yayın başlığı (1-140 karakter)" }, { "name": "platform", "type": "string", "required": false, "description": "Yalnızca bir platformu güncellemek için Kick, Twitch veya YouTube. Gönderilmezse tümü güncellenir." } ], "example_request_body": { "title": "Yeni yayın başlığım!" }, "example_success_response": { "success": true, "platform": "all" }, "rate_limit_per_minute": 20 }, { "scope": "get-stream-meta", "scope_label": "Yayın Bilgilerini Getir", "name": "Yayın Bilgilerini Getir", "description": "POST methodu ile yayın meta bilgilerini döner. viewer_count ve followers_count dahil edilir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-stream-meta", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": {}, "example_success_response": { "success": true, "platform": "Kick", "channel": "kanaladi", "title": "Live Stream", "category": "Just Chatting", "category_id": "123", "viewer_count": 245, "followers_count": 19234, "is_live_any": 1, "is_live_kick": 1, "is_live_twitch": 0, "kick_last_connection ": "2026-04-18" }, "rate_limit_per_minute": 120 }, { "scope": "set-stream-meta", "scope_label": "Yayın Bilgilerini Güncelle", "name": "Yayın Bilgilerini Güncelle", "description": "Başlık ve/veya oyun bilgisini tek istekte günceller. Platform gönderilmezse tüm uygun platformlar, gönderilirse yalnızca seçilen platform güncellenir. title, game veya kick_category_id alanlarından en az biri gönderilmelidir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/set-stream-meta", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "title", "type": "string", "required": false, "description": "Yeni yayın başlığı (1-140 karakter)" }, { "name": "game", "type": "string", "required": false, "description": "Oyun/kategori adı" }, { "name": "kick_category_id", "type": "integer", "required": false, "description": "Doğrudan Kick kategori ID" }, { "name": "platform", "type": "string", "required": false, "description": "Kick, Twitch veya yalnızca başlık değişiminde YouTube. Gönderilmezse tüm uygun platformlar güncellenir." } ], "example_request_body": { "title": "Yeni Başlık", "game": "Valorant" }, "example_success_response": { "success": true, "platform": "all", "title_updated": true, "game_updated": true, "title": "New Title", "category": "VALORANT", "viewer_count": 245, "followers_count": 19234 }, "rate_limit_per_minute": 30 } ] }, { "key": "alerts", "name": "Alert ve Event", "endpoints": [ { "scope": "trigger-audio-alert", "scope_label": "Audio Alert Tetikle", "name": "Audio Alert Tetikle", "description": "Aktif bir audio alerti ID veya isim ile tetikler. Overlay bağlantısı zorunludur.", "method": "POST", "url": "https://api.missxss.com.tr/v1/trigger-audio-alert", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "id", "type": "integer", "required": false, "description": "Audio alert ID (id veya name zorunlu)" }, { "name": "name", "type": "string", "required": false, "description": "Audio alert adı (id veya name zorunlu)" }, { "name": "username", "type": "string", "required": false, "description": "Alert üzerinde gözükecek kullanıcı adı (varsayılan: API)" } ], "example_request_body": { "id": 849, "name": "airhorn", "username": "api_bot" }, "example_success_response": { "success": true, "id": 12, "alert_id": "A12", "name": "airhorn" }, "rate_limit_per_minute": 60 }, { "scope": "list-audio-alerts", "scope_label": "Audio Alertleri Listele", "name": "Audio Alertleri Listele", "description": "Audio alert kayıtlarını ID, isim ve puan bilgisiyle listeler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/list-audio-alerts", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "status", "type": "string", "required": false, "description": "Filtre: all | active | inactive (varsayılan: all)" }, { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-200, varsayılan: 50)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" } ], "example_request_body": { "status": "active", "limit": 20, "offset": 0 }, "example_success_response": { "success": true, "total": 2, "limit": 20, "offset": 0, "alerts": [ { "id": 14, "name": "airhorn", "points": 500, "status": "active" } ] }, "rate_limit_per_minute": 90 }, { "scope": "send-donation", "scope_label": "Bağış Simülasyonu Gönder", "name": "Bağış Simülasyonu Gönder", "description": "BynoGame, StreamElements, StreamLabs veya Ko-fi bağışı gelmiş gibi işleyip event kaydı oluşturur ve bağış alertini tetikler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/send-donation", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "provider", "type": "string", "required": true, "description": "BynoGame | StreamElements | StreamLabs | Ko-fi" }, { "name": "amount", "type": "number", "required": true, "description": "Bağış miktarı (pozitif)" }, { "name": "currency", "type": "string", "required": true, "description": "Kur Türü ($ € ₺ vb.)" }, { "name": "username", "type": "string", "required": false, "description": "Bağış yapan kullanıcı adı (varsayılan: api_donor)" }, { "name": "displayname", "type": "string", "required": false, "description": "Bağış yapan görünen ad" }, { "name": "message", "type": "string", "required": false, "description": "Bağış mesajı" }, { "name": "userid", "type": "string", "required": false, "description": "Bağış yapan kullanıcı ID (opsiyonel)" }, { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "provider": "StreamLabs", "amount": 50, "currency": "₺", "username": "viewer123", "displayname": "Viewer123", "message": "GG!" }, "example_success_response": "{\"success\": true, \"provider\": \"StreamLabs\", \"amount\": 50, \"currency\" => \"₺\", \"username\": \"viewer123\", \"displayname\": \"Viewer123\", \"message\": \"GG!\"}", "rate_limit_per_minute": 90 }, { "scope": "get-recent-activity", "scope_label": "Son Aktivite Özeti", "name": "Son Aktivite Özeti", "description": "Son takipçi, abone, banlanan, bağışçı, Kick bit ve Twitch bit kayıtlarını tek istekte döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-recent-activity", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "limit", "type": "integer", "required": false, "description": "Her liste için kayıt sayısı (1-20, varsayılan: 5)" } ], "example_request_body": { "limit": 5 }, "example_success_response": { "success": true, "limit": 5, "latest_followers": [], "latest_subscribers": [], "latest_banned": [], "latest_donors": [], "latest_kick_bits": [], "latest_twitch_bits": [] }, "rate_limit_per_minute": 60 } ] }, { "key": "effects", "name": "Efektler", "endpoints": [ { "scope": "effect-trigger", "scope_label": "Efekt Tetikle", "name": "Efekt Tetikle", "description": "Trigger destekli efekt overlayini API uzerinden tetikler. Payload icinde action, overlay_id, effect_type, effect_settings ve data gonderilir; options gonderilmez. data bos birakilirsa varsayilan olarak sadece data.userstate gelir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/effect-trigger", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "overlay_id", "type": "string", "required": false, "description": "Tetiklenecek efekt overlay ID (overlay_id veya overlay_ids zorunlu)" }, { "name": "overlay_ids", "type": "array", "required": false, "description": "Birden fazla overlay tetiklemek icin overlay ID listesi (maksimum 20)" }, { "name": "platform", "type": "string", "required": false, "description": "Varsayilan userstate platformu: Kick, Twitch, YouTube veya TikTok (varsayilan: Kick)" }, { "name": "data", "type": "object", "required": false, "description": "Efekt koduna aktarilacak ozel JSON obje. Bos gonderilirse sadece userstate eklenir; gonderilirse userstate ile birlikte kendi alanlariniz payload.data icinde yer alir." } ], "example_request_body": { "overlay_id": "effect_overlay_1", "data": { "message": "API trigger", "amount": 100, "userstate": { "username": "api_user", "displayname": "API User", "platform": "Kick" } } }, "example_success_response": { "success": true, "triggered": 1, "total": 1, "results": [ { "overlay_id": "effect_overlay_1", "success": true, "error": null } ], "data_keys": [ "message", "amount", "userstate" ] }, "rate_limit_per_minute": 120 } ] }, { "key": "community", "name": "Topluluk Verileri", "endpoints": [ { "scope": "get-kick-subscribers", "scope_label": "Kick Abonelerini Listele", "name": "Kick Abonelerini Listele", "description": "kick_subscribers tablosundaki aboneleri listeler. Varsayılan olarak sadece süresi geçmemiş aboneler döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-kick-subscribers", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "include_expired", "type": "boolean|string", "required": false, "description": "1/true gönderilirse süresi geçmiş aboneler de dahil edilir" }, { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-200, varsayılan: 50)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" } ], "example_request_body": { "include_expired": 0, "limit": 20, "offset": 0 }, "example_success_response": { "success": true, "total": 12, "limit": 20, "offset": 0, "include_expired": 0, "subscribers": [ { "id": 1, "kick_user_id": "123", "kick_username": "viewer", "kick_displayname": "Viewer", "subscription_type": "self", "tier": 1 } ] }, "rate_limit_per_minute": 60 } ] }, { "key": "music", "name": "Müzik ve Song Request", "endpoints": [ { "scope": "start-song", "scope_label": "Şarkıyı Başlat / Devam Ettir", "name": "Şarkıyı Başlat / Devam Ettir", "description": "Duraklatılmış şarkıyı devam ettirir veya çalmayı başlatır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/start-song", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true }, "rate_limit_per_minute": 30 }, { "scope": "stop-song", "scope_label": "Şarkıyı Duraklat", "name": "Şarkıyı Duraklat", "description": "Çalmakta olan şarkıyı duraklatır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/stop-song", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true }, "rate_limit_per_minute": 30 }, { "scope": "skip-song", "scope_label": "Şarkıyı Geç", "name": "Şarkıyı Geç", "description": "Mevcut şarkıyı atlayıp sıradaki şarkıya geçer.", "method": "POST", "url": "https://api.missxss.com.tr/v1/skip-song", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true }, "rate_limit_per_minute": 30 } ] }, { "key": "points", "name": "Puan ve Ekonomi", "endpoints": [ { "scope": "add-points", "scope_label": "Puan Ekle", "name": "Puan Ekle", "description": "Belirtilen kullanıcıya puan ekler. Önce userid (Kick ID) ile aranır, bulunamazsa username ile devam eder.", "method": "POST", "url": "https://api.missxss.com.tr/v1/add-points", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Hedef kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "amount", "type": "number", "required": true, "description": "Eklenecek puan miktarı (1 - 99.999.999)" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "username": "viewer123", "amount": 100 }, "example_success_response": { "success": true }, "rate_limit_per_minute": 90 }, { "scope": "remove-points", "scope_label": "Puan Kaldır", "name": "Puan Kaldır", "description": "Belirtilen kullanıcıdan puan düşer. Önce userid (Kick ID) ile aranır, bulunamazsa username ile devam eder.", "method": "POST", "url": "https://api.missxss.com.tr/v1/remove-points", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Hedef kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "amount", "type": "number", "required": true, "description": "Düşülecek puan miktarı (1 - 99.999.999)" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "username": "viewer123", "amount": 50 }, "example_success_response": { "success": true }, "rate_limit_per_minute": 90 }, { "scope": "get-points", "scope_label": "Kullanıcı Puanını Getir", "name": "Kullanıcı Puanını Getir", "description": "Belirli bir kullanıcının puan/coin/mesaj sayısı bilgisini döner. Önce userid (Kick ID), bulunamazsa username kontrol edilir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-points", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "username": "viewer123" }, "example_success_response": { "success": true, "platform": "Kick", "user_id": "123", "username": "viewer123", "displayname": "Viewer123", "points": 500, "coin": 25, "message_count": 18 }, "rate_limit_per_minute": 120 }, { "scope": "get-points-top", "scope_label": "Puan Sıralamasını Getir", "name": "Puan Sıralamasını Getir", "description": "Puan sıralamasını döner (limit/offset destekli).", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-points-top", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-100, varsayılan: 20)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "limit": 10, "offset": 0 }, "example_success_response": { "success": true, "platform": "Kick", "limit": 10, "offset": 0, "total": 1200, "users": [ { "rank": 1, "username": "topuser", "points": 99999 } ] }, "rate_limit_per_minute": 90 }, { "scope": "set-points", "scope_label": "Puanı Doğrudan Ata", "name": "Puanı Doğrudan Ata", "description": "Kullanıcının puanını doğrudan verilen değere ayarlar. Önce userid (Kick ID), bulunamazsa username kontrol edilir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/set-points", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "amount", "type": "integer", "required": true, "description": "Yeni puan değeri (0 - 99.999.999)" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "username": "viewer123", "amount": 2500 }, "example_success_response": { "success": true, "platform": "Kick", "username": "viewer123", "old_points": 1200, "points": 2500, "changed": 1300 }, "rate_limit_per_minute": 90 }, { "scope": "transfer-points", "scope_label": "Puan Transferi", "name": "Puan Transferi", "description": "Bir kullanıcıdan diğerine puan transfer eder. Gönderen/alıcı için önce userid, bulunamazsa username fallback kullanılır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/transfer-points", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "from_userid", "type": "string", "required": false, "description": "Gönderen kullanıcı ID" }, { "name": "from_username", "type": "string", "required": false, "description": "Gönderen kullanıcı adı (@ işaretsiz), fallback" }, { "name": "to_userid", "type": "string", "required": false, "description": "Alıcı kullanıcı ID" }, { "name": "to_username", "type": "string", "required": false, "description": "Alıcı kullanıcı adı (@ işaretsiz), fallback" }, { "name": "amount", "type": "integer", "required": true, "description": "Transfer miktarı (1 - 99.999.999)" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "from_userid": "111", "from_username": "alice", "to_userid": "222", "to_username": "bob", "amount": 100 }, "example_success_response": { "success": true, "platform": "Kick", "from_username": "alice", "from_user_id": "111", "to_username": "bob", "to_user_id": "222", "amount": 100 }, "rate_limit_per_minute": 90 } ] }, { "key": "watchtime", "name": "İzleme Süresi", "endpoints": [ { "scope": "adjust-watch-time", "scope_label": "İzleme Süresi Düzenle", "name": "İzleme Süresi Düzenle", "description": "İzleme süresini add/remove/set modlarıyla düzenler. amount değeri dakika cinsindendir. day verilmezse toplam istatistiği artırmak için eski bir fallback tarih kullanılır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/adjust-watch-time", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Hedef kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "mode", "type": "string", "required": true, "description": "İşlem modu: add | remove | set" }, { "name": "amount", "type": "integer", "required": true, "description": "Dakika cinsinden miktar. add/remove için min 1, set için min 0 (maksimum 99.999.999 dakika)" }, { "name": "day", "type": "string", "required": false, "description": "Hedef gün (YYYY-MM-DD). Gönderilmezse fallback tarih kullanılır." }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "mode": "add", "amount": 30, "day": "2026-04-17" }, "example_success_response": { "success": true, "platform": "Kick", "user_id": "123456", "username": "viewer123", "displayname": "Viewer123", "mode": "add", "amount": 30, "amount_unit": "minute", "day": "2026-04-17", "used_fallback_day": 0, "watch_time": 245, "watch_time_unit": "minute" }, "rate_limit_per_minute": 60 }, { "scope": "get-watch-time", "scope_label": "İzleme Süresi Sorgula", "name": "İzleme Süresi Sorgula", "description": "Tek kullanıcı için izleme süresi ve mesaj sayısını döner. day ile tek gün, date_from/date_to ile aralık, hiçbir tarih gönderilmezse tüm zamanlar sorgulanır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-watch-time", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "userid", "type": "string", "required": false, "description": "Hedef kullanıcı ID" }, { "name": "username", "type": "string", "required": false, "description": "Hedef kullanıcı adı (@ işaretsiz). userid bulunamazsa fallback olarak kullanılır." }, { "name": "day", "type": "string", "required": false, "description": "Tek gün filtresi (YYYY-MM-DD)" }, { "name": "date_from", "type": "string", "required": false, "description": "Aralık başlangıç tarihi (YYYY-MM-DD), date_to ile birlikte gönderilmelidir" }, { "name": "date_to", "type": "string", "required": false, "description": "Aralık bitiş tarihi (YYYY-MM-DD), date_from ile birlikte gönderilmelidir" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "userid": "123456", "day": "2026-04-17" }, "example_success_response": { "success": true, "platform": "Kick", "user_id": "123456", "username": "viewer123", "displayname": "Viewer123", "query_mode": "day", "day": "2026-04-17", "date_from": null, "date_to": null, "watch_time": 245, "watch_time_unit": "minute", "message_count": 18 }, "rate_limit_per_minute": 120 }, { "scope": "get-watch-time-top", "scope_label": "İzleme Süresi Sıralaması", "name": "İzleme Süresi Sıralaması", "description": "İzleme süresine göre kullanıcı sıralaması döner. day veya date_from/date_to ile filtrelenebilir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-watch-time-top", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-100, varsayılan: 20)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" }, { "name": "day", "type": "string", "required": false, "description": "Tek gün filtresi (YYYY-MM-DD)" }, { "name": "date_from", "type": "string", "required": false, "description": "Aralık başlangıç tarihi (YYYY-MM-DD), date_to ile birlikte gönderilmelidir" }, { "name": "date_to", "type": "string", "required": false, "description": "Aralık bitiş tarihi (YYYY-MM-DD), date_from ile birlikte gönderilmelidir" }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "day": "2026-04-17", "limit": 10, "offset": 0 }, "example_success_response": { "success": true, "platform": "Kick", "query_mode": "day", "day": "2026-04-17", "date_from": null, "date_to": null, "limit": 10, "offset": 0, "total": 152, "watch_time_unit": "minute", "users": [ { "rank": 1, "user_id": "123456", "username": "viewer123", "displayname": "Viewer123", "watch_time": 245, "message_count": 18 } ] }, "rate_limit_per_minute": 90 }, { "scope": "adjust-watch-time-bulk", "scope_label": "Toplu İzleme Süresi Düzenle", "name": "Toplu İzleme Süresi Düzenle", "description": "Bir istekte birden fazla kullanıcı için izleme süresi düzenler. amount değeri dakika cinsindendir. Her kullanıcı satırında amount verilebilir; verilmezse request içindeki default amount kullanılır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/adjust-watch-time-bulk", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "mode", "type": "string", "required": true, "description": "İşlem modu: add | remove | set" }, { "name": "day", "type": "string", "required": false, "description": "Hedef gün (YYYY-MM-DD). Gönderilmezse fallback tarih kullanılır." }, { "name": "amount", "type": "integer", "required": false, "description": "Default dakika miktarı. users[].amount boşsa kullanılır." }, { "name": "users", "type": "array", "required": true, "description": "1-100 kullanıcı listesi. Her elemanda userid veya username ve opsiyonel amount bulunur." }, { "name": "platform", "type": "string", "required": true, "description": "Zorunlu platform: Kick, Twitch, YouTube veya TikTok" } ], "example_request_body": { "platform": "Kick", "mode": "add", "day": "2026-04-17", "users": [ { "userid": "123456", "amount": 30 }, { "username": "viewer2", "amount": 15 } ] }, "example_success_response": { "success": true, "partial": 0, "platform": "Kick", "mode": "add", "day": "2026-04-17", "used_fallback_day": 0, "amount_unit": "minute", "watch_time_unit": "minute", "total_requested": 2, "processed_count": 2, "failed_count": 0, "users": [ { "index": 0, "user_id": "123456", "username": "viewer123", "displayname": "Viewer123", "mode": "add", "amount": 30, "day": "2026-04-17", "watch_time": 245, "message_count": 18 } ], "failed": [] }, "rate_limit_per_minute": 20 } ] }, { "key": "commands", "name": "Komut Yönetimi", "endpoints": [ { "scope": "run-command", "scope_label": "Komut Çalıştır", "name": "Komut Çalıştır", "description": "MissXss panelinde tanımladığınız bir chat komutunu çalıştırır. Komut adı veya komut ID ile çağrılabilir. Komutun cevap mesajı gönderilir ve varsa aksiyonları (timeout, ban, voicemod vb.) otomatik olarak işlenir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/run-command", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı (ör: \"!selam\" veya \"selam\"). command veya id zorunlu." }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID değeri. command veya id zorunlu." }, { "name": "message", "type": "string", "required": false, "description": "Komuta eklenecek ek mesaj / argümanlar" }, { "name": "username", "type": "string", "required": false, "description": "Komutu çalıştıran kullanıcı adı (varsayılan: yayıncı adı)" } ], "example_request_body": { "command": "!hello" }, "example_success_response": { "success": true, "id": 22029, "command": "!hello", "active": 1, "response": "Herkese merhaba!" }, "rate_limit_per_minute": 90 }, { "scope": "list-commands", "scope_label": "Komutları Listele (Detaylı)", "name": "Komutları Listele (Detaylı)", "description": "Yayıncıya ait tüm komutları detaylı döner. run-command ve toggle-command için komut ID öğrenmek amacıyla kullanılabilir. Response alanları: total=toplam komut sayısı; commands[]=komut listesi; id=komut ID; command=ana komut adı; aliases=eşdeğer komutlar; active=aktiflik (1/0); show_in_list=komutlar listesinde gösterim; cooldown_global_seconds=tüm chat için bekleme süresi; cooldown_user_seconds=kullanıcı bazlı bekleme süresi; message=komut cevabı; permissions=izinli yetkiler; denied_permissions=engelli yetkiler; action_json=komut aksiyon JSON; platform_kick/platform_twitch/platform_tiktok/platform_youtube=platform aktiflikleri; auto_message_interval_minutes=otomatik gönderim dakikası; auto_message_min_chat_count=yeniden otomatik gönderim için minimum chat mesaj sayısı; last_run_at=son kullanım zamanı; last_global_run_at=global son kullanım zamanı; last_user_run_data=kullanıcı bazlı son kullanım verisi; points_cost/coin_cost/delete_cost=komut maliyetleri; only_game_ids=sadece bu kategori(ler)de çalışır; blocked_game_ids=bu kategori(ler)de çalışmaz; last_auto_message_kick_at/last_auto_message_twitch_at=platform bazlı son otomatik gönderim zamanı; raw=bellekteki ham komut objesi.", "method": "POST", "url": "https://api.missxss.com.tr/v1/list-commands", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true, "total": 2, "commands": [ { "id": 22029, "command": "!hello", "aliases": [ "!hello", "hello" ], "active": 1, "show_in_list": 0, "cooldown_global_seconds": 0, "cooldown_user_seconds": 0, "message": "Hello!", "permissions": "", "denied_permissions": "", "action_json": "", "platform_kick": 1, "platform_twitch": 1, "platform_tiktok": 1, "platform_youtube": 1, "auto_message_interval_minutes": 0, "auto_message_min_chat_count": 0, "last_run_at": 0, "last_global_run_at": 0, "last_user_run_data": false, "points_cost": 0, "coin_cost": 0, "delete_cost": 0, "only_game_ids": "", "blocked_game_ids": "", "last_auto_message_kick_at": 0, "last_auto_message_twitch_at": 0, "raw": { "id": 22029 } } ] }, "rate_limit_per_minute": 90 }, { "scope": "toggle-command", "scope_label": "Komutu Aç / Kapat", "name": "Komutu Aç / Kapat", "description": "Bir komutu adı veya ID ile açar, kapatır ya da toggle eder. mode değeri: on | off | toggle.", "method": "POST", "url": "https://api.missxss.com.tr/v1/toggle-command", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı. command veya id zorunlu." }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID değeri. command veya id zorunlu." }, { "name": "mode", "type": "string", "required": true, "description": "İşlem modu: on | off | toggle" } ], "example_request_body": { "id": 22029, "mode": "off" }, "example_success_response": { "success": true, "id": 22029, "command": "!hello", "active": 0, "changed": true, "mode": "off" }, "rate_limit_per_minute": 60 }, { "scope": "create-command", "scope_label": "Komut Oluştur", "name": "Komut Oluştur", "description": "Yeni komut oluşturur ve komut listesine ekler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/create-command", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": true, "description": "Komut adı (maks. 50 karakter)" }, { "name": "message", "type": "string", "required": true, "description": "Komut cevabı" } ], "example_request_body": { "command": "!hi", "message": "Hello everyone!" }, "example_success_response": { "success": true, "id": 22035, "command": "!hi", "aliases": [ "!hi" ], "active": 1 }, "rate_limit_per_minute": 60 }, { "scope": "update-command", "scope_label": "Komut Güncelle", "name": "Komut Güncelle", "description": "Komut mesajını ve/veya alias listesini günceller.", "method": "POST", "url": "https://api.missxss.com.tr/v1/update-command", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı (command veya id zorunlu)" }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID (command veya id zorunlu)" }, { "name": "message", "type": "string", "required": false, "description": "Yeni komut cevabı" }, { "name": "aliases", "type": "string|array", "required": false, "description": "Yeni alias listesi (virgüllü string veya dizi)" } ], "example_request_body": { "id": 22035, "message": "Hello there!" }, "example_success_response": { "success": true, "id": 22035, "command": "!hi", "aliases": [ "!hi", "!hello" ], "message": "Hello there!" }, "rate_limit_per_minute": 60 }, { "scope": "delete-command", "scope_label": "Komut Sil", "name": "Komut Sil", "description": "Komutu adı veya ID ile siler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/delete-command", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı (command veya id zorunlu)" }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID (command veya id zorunlu)" } ], "example_request_body": { "id": 22035 }, "example_success_response": { "success": true, "deleted": true, "command": "selam", "id": 22035 }, "rate_limit_per_minute": 60 }, { "scope": "set-command-cooldown", "scope_label": "Komut Cooldown Ayarla", "name": "Komut Cooldown Ayarla", "description": "Komutun global ve kullanıcı bazlı cooldown sürelerini ayarlar.", "method": "POST", "url": "https://api.missxss.com.tr/v1/set-command-cooldown", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı (command veya id zorunlu)" }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID (command veya id zorunlu)" }, { "name": "cooldown_global_seconds", "type": "integer", "required": false, "description": "Global bekleme süresi (0-86400)" }, { "name": "cooldown_user_seconds", "type": "integer", "required": false, "description": "Kullanıcı bazlı bekleme süresi (0-86400)" } ], "example_request_body": { "id": 22029, "cooldown_global_seconds": 10, "cooldown_user_seconds": 30 }, "example_success_response": { "success": true, "id": 22029, "command": "hello", "cooldown_global_seconds": 10, "cooldown_user_seconds": 30 }, "rate_limit_per_minute": 60 }, { "scope": "set-command-platforms", "scope_label": "Komut Platformlarını Ayarla", "name": "Komut Platformlarını Ayarla", "description": "Komutun platform aktifliklerini günceller.", "method": "POST", "url": "https://api.missxss.com.tr/v1/set-command-platforms", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "command", "type": "string", "required": false, "description": "Komut adı (command veya id zorunlu)" }, { "name": "id", "type": "integer", "required": false, "description": "Komut ID (command veya id zorunlu)" }, { "name": "platform_kick", "type": "boolean|integer", "required": false, "description": "Kick aktif (1/0)" }, { "name": "platform_twitch", "type": "boolean|integer", "required": false, "description": "Twitch aktif (1/0)" }, { "name": "platform_tiktok", "type": "boolean|integer", "required": false, "description": "TikTok aktif (1/0)" }, { "name": "platform_youtube", "type": "boolean|integer", "required": false, "description": "YouTube aktif (1/0)" } ], "example_request_body": { "id": 22029, "platform_kick": 1, "platform_twitch": 0, "platform_youtube": 1 }, "example_success_response": { "success": true, "id": 22029, "command": "hello", "platform_kick": 1, "platform_twitch": 0, "platform_tiktok": 1, "platform_youtube": 1 }, "rate_limit_per_minute": 60 } ] }, { "key": "ai", "name": "AI Bot", "endpoints": [ { "scope": "ai-bot", "scope_label": "AI Bot Ayarlarını Güncelle", "name": "AI Bot Ayarlarını Güncelle", "description": "AI Bot ayarlarını bağımsız olarak günceller. İstediğiniz alanı tek başına gönderebilirsiniz. gemini_aktif ve ai_sadeceAbone için on/off/toggle desteklenir. ai_text değişirse konuşma geçmişi otomatik temizlenir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/ai-bot", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "gemini_aktif", "type": "string", "required": false, "description": "AI Bot durumu: on | off | toggle" }, { "name": "ai_sadeceAbone", "type": "string", "required": false, "description": "Sadece abonelere özel mod: on | off | toggle" }, { "name": "ai_text", "type": "string", "required": false, "description": "AI Bot prompt metni (maksimum 12000 karakter)" } ], "example_request_body": { "gemini_aktif": "on" }, "example_success_response": { "success": true, "gemini_aktif": 1, "ai_sadeceAbone": 0, "ai_text_updated": true, "clearai_triggered": false }, "rate_limit_per_minute": 20 }, { "scope": "clear-ai", "scope_label": "AI Geçmişini Temizle", "name": "AI Geçmişini Temizle", "description": "AI konuşma geçmişini temizler. !clearai komutunun API karşılığıdır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/clear-ai", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true, "cleared": true }, "rate_limit_per_minute": 10 } ] }, { "key": "mod", "name": "Moderasyon", "endpoints": [ { "scope": "timeout", "scope_label": "Timeout", "name": "Timeout", "description": "Bir kullanıcıya belirli süreliğine timeout atar. Süre dakika cinsindendir (maksimum 525600 dakika = 1 yıl).", "method": "POST", "url": "https://api.missxss.com.tr/v1/timeout", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "username", "type": "string", "required": true, "description": "Timeout atılacak kullanıcı adı" }, { "name": "duration", "type": "integer", "required": false, "description": "Süre (dakika). Min: 1, Maks: 525600. Varsayılan: 1" }, { "name": "reason", "type": "string", "required": false, "description": "Timeout sebebi (varsayılan: \"API Timeout\")" }, { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "username": "troll_user", "duration": 5, "reason": "Spam yapma" }, "example_success_response": { "success": true }, "rate_limit_per_minute": 200 }, { "scope": "ban", "scope_label": "Ban", "name": "Ban", "description": "Bir kullanıcıyı kalıcı olarak yasaklar. Dikkatli kullanın.", "method": "POST", "url": "https://api.missxss.com.tr/v1/ban", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "username", "type": "string", "required": true, "description": "Yasaklanacak kullanıcı adı" }, { "name": "userid", "type": "string", "required": false, "description": "Yasaklanacak kullanıcı ID. username ile birlikte gönderilirse userid öncelikli olarak kullanılır." }, { "name": "reason", "type": "string", "required": false, "description": "Ban sebebi (varsayılan: \"API Ban\")" }, { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "username": "bad_user", "reason": "Kural ihlali" }, "example_success_response": { "success": true }, "rate_limit_per_minute": 200 }, { "scope": "clear-chat", "scope_label": "Sohbeti Temizle", "name": "Sohbeti Temizle", "description": "Tüm chat mesajlarını temizler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/clear-chat", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true }, "rate_limit_per_minute": 15 }, { "scope": "shield-mode", "scope_label": "Kalkan Modu Yönet", "name": "Kalkan Modu Yönet", "description": "Kalkan modunu açar, kapatır veya toggle eder. mode parametresi: on, off, toggle.", "method": "POST", "url": "https://api.missxss.com.tr/v1/shield-mode", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "mode", "type": "string", "required": false, "description": "İşlem modu: on | off | toggle (varsayılan: toggle)" }, { "name": "duration", "type": "integer", "required": false, "description": "Kalkan ban kontrol penceresi (dakika, min: 0). Sadece açma/toggle->açık sırasında kullanılır." } ], "example_request_body": { "mode": "on" }, "example_success_response": { "success": true, "shield_mode": 1, "changed": true, "mode": "on" }, "rate_limit_per_minute": 15 }, { "scope": "get-shield-mode-status", "scope_label": "Kalkan Modu Durumu", "name": "Kalkan Modu Durumu", "description": "Kalkan modu ayarlarını mevcut durumuyla döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-shield-mode-status", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true, "shield_mode": 1, "shield_ban_enabled": 1, "shield_lookback_minutes": 2 }, "rate_limit_per_minute": 90 }, { "scope": "set-moderation-feature", "scope_label": "Moderasyon Özelliği Aç / Kapat", "name": "Moderasyon Özelliği Aç / Kapat", "description": "Belirli moderasyon özelliğini açar, kapatır veya toggle eder.", "method": "POST", "url": "https://api.missxss.com.tr/v1/set-moderation-feature", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "feature", "type": "string", "required": true, "description": "username_kontrol, spam_korumasi, link_korumasi, kufur_korumasi, caps_korumasi, flood_korumasi, coklu_hesap_spam, ziyaretci_kontrol" }, { "name": "mode", "type": "string", "required": true, "description": "on | off | toggle" } ], "example_request_body": { "feature": "spam_korumasi", "mode": "on" }, "example_success_response": { "success": true, "feature": "spam_korumasi", "enabled": 1, "changed": true, "mode": "on" }, "rate_limit_per_minute": 10 }, { "scope": "get-moderation-status", "scope_label": "Moderasyon Durumu", "name": "Moderasyon Durumu", "description": "Tüm moderasyon modüllerinin açık/kapalı durumunu döner. feature gönderilirse tek modül durumu döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-moderation-status", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "feature", "type": "string", "required": false, "description": "Opsiyonel tek modül adı" } ], "example_request_body": {}, "example_success_response": { "success": true, "status": { "username_kontrol": 1, "spam_korumasi": 1, "link_korumasi": 1, "kufur_korumasi": 1, "caps_korumasi": 1, "flood_korumasi": 1, "coklu_hesap_spam": 0, "ziyaretci_kontrol": 1, "kalkan_modu": 0, "kalkan_ban": 1, "kalkan_sure": 2 } }, "rate_limit_per_minute": 90 }, { "scope": "get-platform-ban-list", "scope_label": "Platform Ban Listesi", "name": "Platform Ban Listesi", "description": "platform_ban_list tablosundaki ban kayıtlarını listeler.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-platform-ban-list", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "platform", "type": "string", "required": false, "description": "Kick | Twitch | YouTube | TikTok (opsiyonel filtre)" }, { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-200, varsayılan: 50)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" } ], "example_request_body": { "platform": "Kick", "limit": 20, "offset": 0 }, "example_success_response": { "success": true, "total": 8, "limit": 20, "offset": 0, "platform": "Kick", "bans": [ { "id": 15, "platform": "Kick", "banned_id": "123", "banned_username": "baduser", "reason": "spam" } ] }, "rate_limit_per_minute": 60 }, { "scope": "get-moderation-log", "scope_label": "Moderasyon Logları", "name": "Moderasyon Logları", "description": "Moderasyon kayıtlarını event tablosundan döner. Kaynak: eventlog() ile yazılan event kayıtlarıdır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/get-moderation-log", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "type", "type": "string", "required": false, "description": "Filtre: all | ban | timeout | shield (varsayılan: all)" }, { "name": "limit", "type": "integer", "required": false, "description": "Kayıt sayısı (1-50, varsayılan: 25)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan: 0)" } ], "example_request_body": { "type": "all", "limit": 25, "offset": 0 }, "example_success_response": { "success": true, "source": "event", "type": "all", "limit": 25, "offset": 0, "logs": [ { "id": 991, "type": "Timeout", "username": "user1", "date": "2026-03-29 14:20:00" } ] }, "rate_limit_per_minute": 60 }, { "scope": "unban-user", "scope_label": "Kullanıcı Unban", "name": "Kullanıcı Unban", "description": "Belirtilen kullanıcı üzerindeki banı kaldırır.", "method": "POST", "url": "https://api.missxss.com.tr/v1/unban-user", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "username", "type": "string", "required": true, "description": "Unban yapılacak kullanıcı adı" }, { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "username": "old_banned_user" }, "example_success_response": { "success": true, "username": "old_banned_user", "platform": "Kick" }, "rate_limit_per_minute": 60 }, { "scope": "undo-last-ban", "scope_label": "Son Banı Geri Al", "name": "Son Banı Geri Al", "description": "Platformun canlı aktif ban listesini yeniler ve en son uygulanan banı kaldırır. Banın MissXss, yayıncı veya başka bir moderatör tarafından uygulanmış olması fark etmez. Kick ve Twitch desteklenir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/undo-last-ban", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "platform": "Kick" }, "example_success_response": { "success": true, "action": "unban", "platform": "Kick", "user": { "id": "123", "username": "viewer", "displayname": "Viewer" }, "original_ban": { "moderator": "moderator", "reason": "spam", "banned_at": "2026-07-15 18:30:00" }, "method": "Kick API" }, "rate_limit_per_minute": 30 }, { "scope": "ban-recent-followers", "scope_label": "Son Takip Edenleri Banlama", "name": "Son Takip Edenleri Banlama", "description": "Son takip eden kişileri hızlı bir şekilde banlayan/timeout atan endpoint. Maksimum 10 kişiye kadar ban atabilir. offset parametresi ile hangi pozisyondan başlayacağını (1 = en son takip eden), count parametresi ile kaç kişiye ban atılacağını belirlersiniz.", "method": "POST", "url": "https://api.missxss.com.tr/v1/ban-recent-followers", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "action", "type": "string", "required": true, "description": "ban veya timeout" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç pozisyonu (1 = en son takip eden; varsayılan: 1)" }, { "name": "count", "type": "integer", "required": false, "description": "Kaç kişiye işlem yapılacağı (1-10; varsayılan: 1)" }, { "name": "duration", "type": "integer", "required": false, "description": "Timeout süresi dakika cinsinden, sadece action=timeout için (min: 1, maks: 525600; varsayılan: 1)" }, { "name": "reason", "type": "string", "required": false, "description": "İşlem sebebi (varsayılan: \"API Ban Recent\")" }, { "name": "platform", "type": "string", "required": false, "description": "Kick veya Twitch (varsayılan: Kick)" } ], "example_request_body": { "action": "ban", "offset": 1, "count": 2, "reason": "Spam" }, "example_success_response": { "success": true, "action": "ban", "processed_count": 2, "users": [ { "username": "user1", "userid": "123" }, { "username": "user2", "userid": "456" } ], "failed": [] }, "rate_limit_per_minute": 200 } ] }, { "key": "discord", "name": "Discord Genel", "endpoints": [ { "scope": "discord-status", "scope_label": "Discord Durum Kontrolü", "name": "Discord Durum Kontrolü", "description": "Discord bot bağlantısı, guild/channel bulunurluğu ve temel yetkileri döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-status", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "guild_id", "type": "string", "required": false, "description": "Discord sunucu ID (gönderilmezse aktif ayarlardan okunur)" }, { "name": "channel_id", "type": "string", "required": false, "description": "Discord mesaj kanalı ID (opsiyonel kontrol)" }, { "name": "log_channel_id", "type": "string", "required": false, "description": "Discord log kanalı ID (opsiyonel kontrol)" } ], "example_request_body": { "guild_id": "123456789012345678" }, "example_success_response": { "success": true, "bot_connected": true, "guild_found": true, "channel_found": true, "permissions": { "manage_roles": true, "move_members": true, "mute_members": true } }, "rate_limit_per_minute": 90 }, { "scope": "discord-channels", "scope_label": "Discord Kanal Listesi", "name": "Discord Kanal Listesi", "description": "Discord bağlantısı sırasında erişim verilen sunucuları ve bu sunuculardaki metin, duyuru ve ses kanallarını kayıtlı kanal önbelleğinden döner. Her sunucu ve kanalın ID bilgisi yanıtta bulunur.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-channels", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [], "example_request_body": {}, "example_success_response": { "success": true, "total_guilds": 1, "total_channels": 3, "total_text_channels": 2, "total_voice_channels": 1, "guilds": [ { "id": "123456789012345678", "name": "My Server", "channels": [ { "id": "234567890123456789", "name": "general", "type": "text" }, { "id": "345678901234567890", "name": "announcements", "type": "announcement" } ], "voice_channels": [ { "id": "456789012345678901", "name": "Lobby", "type": "voice" } ] } ] }, "rate_limit_per_minute": 90 }, { "scope": "discord-send-message", "scope_label": "Discord Mesaj Gönder", "name": "Discord Mesaj Gönder", "description": "Kendi Discord guildine ait bir kanalına metin veya embed mesaj gönderir. Kanal ID zorunludur ve güvenlik kontrolüne göre ihtiyaç duyduğunuz guild'e ait olması gerekir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-send-message", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "channel_id", "type": "string", "required": true, "description": "Hedef Discord kanal ID (zorunlu, kendi guild'ine ait olmalı)" }, { "name": "message", "type": "string", "required": false, "description": "Gönderilecek metin mesajı (maksimum 2000 karakter)" }, { "name": "embed_title", "type": "string", "required": false, "description": "Embed mesaj başlığı (maksimum 256 karakter)" }, { "name": "embed_description", "type": "string", "required": false, "description": "Embed mesaj açıklaması (maksimum 4096 karakter)" }, { "name": "embed_color", "type": "string", "required": false, "description": "Embed renk kodu (hex: #FF5733 veya decimal: 16721715)" } ], "example_request_body": { "channel_id": "1383215007457611957", "message": "Merhaba Discord!" }, "example_success_response": { "success": true, "channel_id": "1383215007457611957", "guild_id": "700705230106394645", "message_id": "1445427371040571642" }, "rate_limit_per_minute": 30 }, { "scope": "discord-linked-users", "scope_label": "Discord Bağlı Kullanıcıları Listele", "name": "Discord Bağlı Kullanıcıları Listele", "description": "Bu yayıncıya bağlı Discord-Kick/Twitch bağlantı kayıtlarını sayfalı döner.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-linked-users", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "limit", "type": "integer", "required": false, "description": "Sayfa başına kayıt (1-200, varsayılan 50)" }, { "name": "offset", "type": "integer", "required": false, "description": "Başlangıç ofseti (varsayılan 0)" } ], "example_request_body": { "limit": 50, "offset": 0 }, "example_success_response": { "success": true, "total": 120, "limit": 50, "offset": 0, "users": [ { "id": 1, "discord_id": "123", "kick_id": "456", "twitch_id": "789" } ] }, "rate_limit_per_minute": 90 } ] }, { "key": "discord-voice", "name": "Discord Ses Yönetimi", "endpoints": [ { "scope": "discord-voice-members", "scope_label": "Discord Ses Üyelerini Listele", "name": "Discord Ses Üyelerini Listele", "description": "Guild içindeki tüm ses kanallarını veya tek bir ses kanalındaki üyeleri döner. Guild ID otomatik olarak hesap ayarlarından okunur.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-members", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "channel_id", "type": "string", "required": false, "description": "Tek bir ses kanalını filtrelemek için kanal ID" } ], "example_request_body": {}, "example_success_response": { "success": true, "guild_id": "123456789012345678", "total_channels": 2, "channels": [ { "id": "111", "name": "Genel", "member_count": 3 } ] }, "rate_limit_per_minute": 90 }, { "scope": "discord-voice-kick", "scope_label": "Discord Ses Kanalından At", "name": "Discord Ses Kanalından At", "description": "Belirtilen kullanıcıyı bulunduğu ses kanalından çıkarır. Guild ID otomatik olarak hesap ayarlarından okunur (güvenlik nedeniyle).", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-kick", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "discord_id", "type": "string", "required": true, "description": "Atılacak Discord kullanıcı ID" } ], "example_request_body": { "discord_id": "555555555555555555" }, "example_success_response": { "success": true, "discord_id": "555555555555555555", "kicked": true }, "rate_limit_per_minute": 30 }, { "scope": "discord-voice-move", "scope_label": "Discord Kullanıcıyı Taşı", "name": "Discord Kullanıcıyı Taşı", "description": "Belirtilen kullanıcıyı hedef ses kanalına taşır. target_channel_id gönderilmezse kullanıcı, yayıncının o anda bulunduğu ses kanalına çekilir. Yayıncı seste değilse işlem hata döner. Guild ID otomatik olarak hesap ayarlarından okunur.", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-move", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "discord_id", "type": "string", "required": true, "description": "Taşınacak Discord kullanıcı ID" }, { "name": "target_channel_id", "type": "string", "required": false, "description": "Opsiyonel hedef ses kanal ID. Gönderilmezse yayıncının bulunduğu kanal kullanılır." } ], "example_request_body": { "discord_id": "555555555555555555" }, "example_success_response": { "success": true, "discord_id": "555555555555555555", "target_channel_id": "999999999999999999", "moved": true }, "rate_limit_per_minute": 30 }, { "scope": "discord-voice-mute", "scope_label": "Discord Kullanıcı Sustur/Aç", "name": "Discord Kullanıcı Sustur/Aç", "description": "Belirtilen kullanıcıyı susturur, susturmasını kaldırır veya toggle eder. Guild ID otomatik olarak hesap ayarlarından okunur (güvenlik nedeniyle).", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-mute", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "discord_id", "type": "string", "required": true, "description": "Discord kullanıcı ID" }, { "name": "mode", "type": "string", "required": false, "description": "on | off | toggle (varsayılan: toggle)" } ], "example_request_body": { "discord_id": "555555555555555555", "mode": "on" }, "example_success_response": { "success": true, "discord_id": "555555555555555555", "muted": true, "changed": true, "mode": "on" }, "rate_limit_per_minute": 30 }, { "scope": "discord-voice-mute-all", "scope_label": "Discord Herkesi Sustur", "name": "Discord Herkesi Sustur", "description": "Belirtilen ses kanalındaki (bot hariç) tüm kullanıcıları susturur. Guild ID otomatik olarak hesap ayarlarından okunur (güvenlik nedeniyle).", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-mute-all", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "channel_id", "type": "string", "required": true, "description": "Ses kanal ID" } ], "example_request_body": { "channel_id": "999999999999999999" }, "example_success_response": { "success": true, "channel_id": "999999999999999999", "muted_count": 6 }, "rate_limit_per_minute": 30 }, { "scope": "discord-voice-unmute-all", "scope_label": "Discord Herkesin Sesini Aç", "name": "Discord Herkesin Sesini Aç", "description": "Belirtilen ses kanalındaki (bot hariç) tüm kullanıcıların susturmasını kaldırır. Guild ID otomatik olarak hesap ayarlarından okunur (güvenlik nedeniyle).", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-unmute-all", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "channel_id", "type": "string", "required": true, "description": "Ses kanal ID" } ], "example_request_body": { "channel_id": "999999999999999999" }, "example_success_response": { "success": true, "channel_id": "999999999999999999", "unmuted_count": 6 }, "rate_limit_per_minute": 30 }, { "scope": "discord-voice-pull-all", "scope_label": "Discord Herkesi Odaya Çek", "name": "Discord Herkesi Odaya Çek", "description": "Kullanıcıları tek odaya toplar. from_channel_id gönderilirse sadece o odadakileri, gönderilmezse tüm ses kanallarındaki kullanıcıları target_channel_id kanalına taşır. Guild ID otomatik olarak hesap ayarlarından okunur (güvenlik nedeniyle).", "method": "POST", "url": "https://api.missxss.com.tr/v1/discord-voice-pull-all", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "target_channel_id", "type": "string", "required": true, "description": "Taşınacak hedef ses kanal ID" }, { "name": "from_channel_id", "type": "string", "required": false, "description": "Kaynak ses kanal ID (opsiyonel)" } ], "example_request_body": { "target_channel_id": "999999999999999999" }, "example_success_response": { "success": true, "target_channel_id": "999999999999999999", "source_channel_id": null, "moved_count": 4 }, "rate_limit_per_minute": 30 } ] }, { "key": "voicemod", "name": "Voicemod", "endpoints": [ { "scope": "voicemod-voice-change", "scope_label": "Ses Değiştir", "name": "Ses Değiştir", "description": "Voicemod üzerinden ses efekti değiştirir. Overlay bağlantısı gereklidir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/voicemod-voice-change", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "voice", "type": "string", "required": true, "description": "Ses efekti adı (ör: \"baby\", \"deep\")" }, { "name": "wait_time", "type": "integer", "required": false, "description": "Efekt süresi (saniye, varsayılan: 60)" }, { "name": "original_voice", "type": "integer", "required": false, "description": "Süre sonunda orijinal sese dön (0 veya 1, varsayılan: 0)" } ], "example_request_body": { "voice": "baby", "wait_time": 60 }, "example_success_response": { "success": true }, "rate_limit_per_minute": 60 }, { "scope": "voicemod-effect-play", "scope_label": "Ses Efekti Çal", "name": "Ses Efekti Çal", "description": "Voicemod sesli meme efekti çalar (soundboard).", "method": "POST", "url": "https://api.missxss.com.tr/v1/voicemod-effect-play", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "voice", "type": "string", "required": true, "description": "Efekt adı" } ], "example_request_body": { "voice": "applause" }, "example_success_response": { "success": true }, "rate_limit_per_minute": 60 }, { "scope": "voicemod-hear-self", "scope_label": "Kendi Sesini Duy", "name": "Kendi Sesini Duy", "description": "Voicemod \"Kendi Sesini Duy\" özelliğini belirli süreliğine aktifleştirir.", "method": "POST", "url": "https://api.missxss.com.tr/v1/voicemod-hear-self", "headers": { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, "parameters": [ { "name": "wait_time", "type": "integer", "required": false, "description": "Süre (saniye, varsayılan: 60)" } ], "example_request_body": { "wait_time": 120 }, "example_success_response": { "success": true }, "rate_limit_per_minute": 60 } ] } ], "common_errors": [ { "status": 200, "description": "İstek başarıyla tamamlandı." }, { "status": 400, "description": "Geçersiz istek. Parametreleri kontrol edin." }, { "status": 401, "description": "Yetkilendirme hatası. API key geçersiz veya eksik." }, { "status": 403, "description": "Erişim engellendi. Bu scope için yetkiniz yok." }, { "status": 404, "description": "Kaynak bulunamadı (kullanıcı, komut vb.)." }, { "status": 429, "description": "Çok fazla istek gönderildi. Biraz bekleyin." }, { "status": 500, "description": "Sunucu hatası. Tekrar deneyin veya destek alın." }, { "status": 502, "description": "Arka plan servisi yanıt vermiyor." } ] }